home *** CD-ROM | disk | FTP | other *** search
Text File | 1985-10-08 | 217.0 KB | 6,730 lines
This is file: FCONSOLE.DOC. It is readable on-line using TYPE. It is also printable on most printers, if they are first set to print 66 lines per page (no perforation skip). It contains overprinted and underlined lines. FANSI-CONSOLE (tm) User Manual _____________ ____ FANSI-CONSOLE (tm) User Manual Version 1.13 - October 8th, 1985 Version 1.13 - October 8th, 1985 No Smoking Software (tm) __ _______ ________ ____ No Smoking Software (tm) (C) Copyright 1984-1985 (C) Copyright 1984-1985 Hersey Micro Consulting, Inc. Hersey Micro Consulting, Inc. P.O. Box 8276 P.O. Box 8276 Ann Arbor, Michigan USA 48107 Ann Arbor, Michigan USA 48107 (313) 994-3259 Voice (313) 994-3259 Voice (313) 994-3946 BBS (11PM-8AM ET) (313) 994-3946 BBS (11PM-8AM ET) ISBN 0-933737-01-7 ISBN 0-933737-01-7 FANSI-CONSOLE NOT FANSI- _____________ ______ FANSI-CONSOLE is NOT a free program. Usage and copying of FANSI- CONSOLE _______ CONSOLE and its abbreviated user manual are subject to extremely friendly licensing terms found within this manual. Dedicated in memory of Ralph Emerson Hersey, inventor, pioneer in the communications industry, and proud grandfather. In his day, he solved some of the world's problems. We hope we may all do the same in ours. We can still hear him say, "That's the system". FANSI-CONSOLE (tm) FANSI (tm) MODEM86 (tm) Hersey Micro _____________ ____ _____ ____ _______ ____ ______ _____ FANSI-CONSOLE (tm), FANSI (tm), MODEM86 (tm), and Hersey Micro Consulting IBM __________ Consulting are trademarks of Hersey Micro Consulting, Inc. IBM is a registered trademark of International Business Machines Corporation. Microsoft MS-DOS VT100 Microsoft and MS-DOS are trademarks of Microsoft Corporation. VT100 VT52 ANSI and VT52 are trademarks of Digital Equipment Corporation. ANSI is a trademark of American National Standards Institute. Most other names of products mentioned in this manual are also trademarks of various other companies, as noted. FANSI-CONSOLE _____________ FANSI-CONSOLE Table of Contents Chapter 1 Introduction 1 FANSI-CONSOLE _____________ 1.1 What is FANSI-CONSOLE? 1 FANSI-CONSOLE _____________ 1.2 What does FANSI-CONSOLE do? 2 1.2.1 Compatibly replaces standard IBM-PC console software 2 1.2.2 Speeds up screen writing 3 1.2.3 Processes more ANSI X3.64 escape sequences 4 1.2.4 Emulates DEC VT100 5 1.2.5 Allows one finger pausing 5 1.2.6 Allows recall of lines scrolled off the screen 6 1.2.7 Allows much more typeahead 6 1.2.8 Allows keyboard macro assignment during running programs 7 1.2.9 Allows more memory for keyboard macros 7 1.2.10 Turns displays off when not in use 7 1.2.11 Allows one finger typing 7 1.2.12 Allows keyboard generated breakpoints 8 1.2.13 Eliminates screen flicker 8 1.2.14 Provides support for 50 line displays 8 1.2.15 Extends the IBM-PC ROM BIOS 9 1.2.16 Provides some control over use of color 9 1.2.17 Provides control over key repeat rate 9 1.2.18 Other features 9 1.3 What about multitasking windowing programs and FANSI-CONSOLE _____________ FANSI-CONSOLE? 10 Chapter 2 Starting Quickly 12 FANSI-CONSOLE _____________ 2.1 Do I have to read the whole FANSI-CONSOLE user manual? 12 2.1.1 NO! 12 FANSI-CONSOLE _____________ 2.2 How do I quickly install FANSI-CONSOLE? 13 2.2.1 Verify distribution diskette 13 2.2.2 Backup distribution diskette 16 2.2.3 Backup system disks 16 2.2.4 Copy FCONSOLE.DEV to system disk 16 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS 17 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS 18 2.2.7 Restart MS(PC)-DOS 19 2.2.8 Add BUFFERS=20 to CONFIG.SYS 20 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE 2.2.9 Modify Prompt 21 2.2.10 Leave enough memory for applications programs 23 FANSI-CONSOLE _____________ 2.3 How do I use FANSI-CONSOLE? 24 2.3.1 Using the Ctrl-F key 24 2.3.2 Using the Ctrl-S key 24 2.3.3 Using the Ctrl-Num-Lock key 25 2.3.4 Using the Ctrl-C or Ctrl-Break keys 25 FANSI-CONSOLE __ _____________ 2.4 How do I uninstall FANSI-CONSOLE? 26 Chapter 3 Detailed Installation 27 3.1 So what is an MS(PC)-DOS device driver, anyway? 27 3.2 What if my needs are ... different? 29 FANSI-CONSOLE _____________ 3.3 "How much memory does FANSI-CONSOLE require?" 46 Chapter 4 Programming Background 47 4.1 Which screen writing method is best? 47 Chapter 5 ANSI X3.64 escape sequences 50 5.1 Why use ANSI X3.64? 50 5.2 What is an ANSI X3.64 escape sequence? 51 5.3 How can my program write the ANSI X3.64 escape sequences? 53 5.3.1 BASIC 54 5.3.2 C 55 5.3.3 PASCAL 56 5.3.4 Assembly Language 57 5.4 What can the ANSI X3.64 escape sequences do? 59 5.5 How do I find out the mnemonic for an ANSI X3.64 escape sequence? 106 5.6 How do I find out the name of an ANSI X3.64 escape sequence? 111 5.6.1 Control Functions 111 5.6.2 Parameter Values 112 Chapter 6 Changing Options at Run-time 114 6.1 Why do I want to change the options at run-time? 114 6.2 What options can I change? 115 6.2.1 FANSI-RM and FANSI-SM parameters 115 6.2.2 FANSI-SOV parameters 130 Chapter 7 ROM BIOS Calls 135 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE 7.1 Do I have to change my ROM BIOS calls? 135 7.2 How do I make keyboard BIOS calls? 137 7.3 How do I make display BIOS calls? 144 Chapter 8 Advanced Features 156 8.1 How do I use the scroll recall feature? 156 8.2 How do I keep the recall buffer from filling? 160 8.3 How do I reenter lines from the recall buffer? 162 8.4 How do I write recall buffer to a file? 163 8.5 How do I rearrange my keyboard keys? 164 FANSI-CONSOLE _____________ 8.6 How do I assign macros to FANSI-CONSOLE keys? 167 8.7 How do I induce breakpoints with the keyboard? 170 8.7.1 Using the Alt-Ctrl-Ins key 170 FANSI-CONSOLE _____________ 8.8 How do I get FANSI-CONSOLE to emulate a VT100? 171 8.8.1 Using the Alt-Ctrl-Num-Lock key 171 FANSI-CONSOLE _____________ 8.9 How do I get FANSI-CONSOLE to be more compatible? 174 8.9.1 Using the Alt-Ctrl-DownArrow key 174 FANSI-CONSOLE _____________ 8.10 How do I get FANSI-CONSOLE to be faster? 174 8.10.1 Using the Alt-Ctrl-UpArrow key 174 8.11 How do I get the console into local mode? 175 8.11.1 Using the Alt-Ctrl-Scroll-Lock key 175 8.12 How do I use the original definition of a key? 176 8.12.1 Using the Alt-Ctrl-Caps key 176 8.13 How do I get a Dvorak keyboard arrangement? 177 8.13.1 Using the Alt-Ctrl-Tab key 177 8.14 How do I get back the normal keyboard arrangement? 177 8.14.1 Using the Alt-Ctrl-Esc key 177 Chapter 9 Compatibility and Limitations 178 FANSI-CONSOLE _____________ 9.1 What do I do if FANSI-CONSOLE gives me problems? 178 9.1.1 Check for the problem in the index under "problem" 178 9.1.2 Check the compatibility lists 178 FANSI-CONSOLE _____________ 9.1.3 Check for problems without FANSI-CONSOLE 179 9.1.4 Check for lack of memory problems 179 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE 9.1.5 Check for interaction problems 179 9.1.6 When all else fails....give us a call 180 FANSI-CONSOLE _____________ 9.2 What limitations does FANSI-CONSOLE have? 181 FANSI-CONSOLE _____________ 9.3 Are there several versions of FANSI-CONSOLE? 182 FANSI-CONSOLE _____________ 9.4 What programs are compatible with FANSI-CONSOLE? 183 FANSI-CONSOLE _____________ 9.5 What computers are compatible with FANSI-CONSOLE? 186 FANSI-CONSOLE __ _____________ 9.6 What programs are incompatible with FANSI-CONSOLE? 188 FANSI-CONSOLE __ _____________ 9.7 What computers are incompatible with FANSI-CONSOLE? 192 Chapter 10 Credits 195 10.1 How did you do that? 195 Chapter 11 Distribution and Licensing 197 FANSI-CONSOLE _____________ 11.1 You mean FANSI-CONSOLE is not freeware? 197 FANSI-CONSOLE _____________ 11.2 How are you limiting my use of FANSI-CONSOLE? 199 11.2.1 Limitations 199 11.2.2 Rights 202 FANSI-CONSOLE _____________ 11.3 How do I know if FANSI-CONSOLE is right for me? 203 11.3.1 DISCLAIMER 203 FANSI-CONSOLE _____________ 11.4 How do I get updated versions of FANSI-CONSOLE? 204 11.5 What do we pay if we have more than one computer? 205 FANSI-CONSOLE _____________ 11.6 Can I get a printed complete FANSI-CONSOLE user manual? 206 FANSI-CONSOLE _____________ 11.7 Can I publish the FANSI-CONSOLE complete user manual? 207 FANSI-CONSOLE _____________ 11.8 Can I buy the FANSI-CONSOLE program source? 207 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction Chapter 1 Chapter 1 Introduction Introduction FANSI-CONSOLE __________________________ 1.1 What is FANSI-CONSOLE? FANSI-CONSOLE (tm) _____________ ____ Briefly, FANSI-CONSOLE (tm) is a fast ANSI X3.64 standard console driver for the IBM-PC, running under MS(PC)-DOS. The name "FANSI" comes from "fast ANSI". It is pronounced the same as "fancy". The "console" is what we call the screen and keyboard together. "MS(PC)- DOS" is the name we use for Microsoft's MS-DOS, of which IBM-PC DOS FANSI-CONSOLE _____________ is a variant. We also call FANSI-CONSOLE "The Integrated Console (tm) ____ Utility (tm)", because it integrates many little console control features into one program. FANSI-CONSOLE _____________ This chapter gives an overview of what FANSI-CONSOLE can do for you, FANSI-CONSOLE _____________ and explains why you will want to use FANSI-CONSOLE. The next FANSI- ______ chapter tells you how to get started, so that you can try FANSI- CONSOLE _______ CONSOLE right away. (C) Copyright 1984-85 Hersey Micro Consulting 1 (C) Copyright 1984-85 Hersey Micro Consulting 1 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _______________________________ 1.2 What does FANSI-CONSOLE do? 1.2.1 Compatibly replaces standard IBM-PC console software _____ __________ ________ ________ ______ _______ ________ 1.2.1 Compatibly replaces standard IBM-PC console software FANSI-CONSOLE _____________ FANSI-CONSOLE is both an MS(PC)-DOS console driver and a BIOS console driver. These are two somewhat similar but still different things. Somewhat like an actor playing the parts of both twins in a movie, FANSI-CONSOLE _____________ FANSI-CONSOLE plays the part of the standard IBM-PC ROM BIOS console software, as well as the part of the standard IBM-PC MS(PC)-DOS console device driver (or the standard IBM-PC ANSI.SYS device FANSI-CONSOLE _____________ driver). FANSI-CONSOLE replaces the screen and keyboard handling parts of both the IBM-PC ROM BIOS and the MS(PC)-DOS 2.00 (and later versions) operating system. It is a complete and mostly compatible replacement for the standard IBM-PC console software, but offers many significant improvements. It also replaces many other small single feature console utilities which may be found in the public domain and on the retail market. FANSI-CONSOLE _____________ Although we try to make FANSI-CONSOLE as compatible as possible to the standard IBM-PC console software, please note that because of the FANSI-CONSOLE _____________ improvements offered, it is impossible for FANSI-CONSOLE to be 100% compatible. For program compatibility information, refer to the chapter entitled "Compatibility and Limitations". We hope to extend the compatibility list, as more people report how well it works with other software. FANSI-CONSOLE _____________ Just like the operating system, FANSI-CONSOLE is always in memory FANSI-CONSOLE _____________ once it is placed there during the startup process. FANSI-CONSOLE ________ _____ __ __ __ __________ ______ requires about 24 KB of read/write memory for itself. In comparison, the standard IBM-PC ANSI.SYS device driver requires about 1.6 KB of FANSI-CONSOLE not _____________ ___ read/write memory for itself. FANSI-CONSOLE does not require any special hardware like a second diskette drive or a fixed disk. It performs just as well without them as with them. (C) Copyright 1984-85 Hersey Micro Consulting 2 (C) Copyright 1984-85 Hersey Micro Consulting 2 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _____________ FANSI-CONSOLE works on most computers and display adapters which are hardware equivalent to the IBM-PC and the IBM monochrome or color graphics adapter. These computers and adapters are sometimes called "compatibles" or "clones". We prefer the term clone. Note that FANSI-CONSOLE _____________ ___ because of the nature of the program, FANSI-CONSOLE does not work on ___ machines which are not hardware equivalent to the IBM-PC. For hardware compatibility information, refer to the chapter entitled "Compatibility and Limitations". We hope to extend the compatibility list, as more people report how well it works on other machines. FANSI-CONSOLE _____________ With any luck, FANSI-CONSOLE will become a standard by which IBM-PC FANSI-CONSOLE _____________ compatibility is measured. Of particular note is that FANSI-CONSOLE now fully supports all the modes of the IBM Enhanced Graphics Adaptor. 1.2.2 Speeds up screen writing _____ ______ __ ______ _______ 1.2.2 Speeds up screen writing FANSI-CONSOLE _____________ The most basic feature of FANSI-CONSOLE is that it speeds up the screen writing of many programs. This includes all MS(PC)-DOS internal commands. "Screen writing" is what we call the process of filling the screen with information by "writing" to it. Any program which uses standard MS(PC)-DOS or IBM-PC ROM BIOS calls to write to the PC screen, instead of direct hardware manipulation, writes to the FANSI- __ ____ __ _____ _____ __ ____ ______ screen as much as three times as fast as it does without FANSI- CONSOLE _______ CONSOLE. Most of the speed ups that we have tested in our file TYPEing benchmarks range between 1.2 and 2.0 times as fast. The speedup of application programs is not always as much as that because of additional overhead in the application program itself. Other programs, those which write directly to the IBM-PC screen memory, are _______ usually unaffected, but see the discussion below about screen FANSI- ______ flicker. A program's screen writing is never slowed down by FANSI- CONSOLE _______ CONSOLE. This means much less waiting for menus and so on to be written onto your screen. Generally, programs that write to the screen slowly are the ones that are speeded up. Programs written to run on any MS(PC)-DOS machine are speeded up. Programs that are quick to begin with are nearly always the programs that write directly to the screen memory, and FANSI-CONSOLE ___ _____________ therefore are not affected by FANSI-CONSOLE. Also, any program that causes hashing (snow) on a standard IBM-PC color graphics display FANSI-CONSOLE _____________ adapter is not affected by FANSI-CONSOLE, because it writes directly to screen memory. For information about which programs are speeded up refer to the compatibility list contained within the chapter entitled "Compatibility and Limitations". (C) Copyright 1984-85 Hersey Micro Consulting 3 (C) Copyright 1984-85 Hersey Micro Consulting 3 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction The amount of the speed up depends upon: - how much overhead the application program itself is adding to the screen writing, - the type of display adapter used, - the screen mode, - what type of screen writing calls are used, - whether scrolling is necessary, - what brand of IBM-PC equivalent machine you have, FANSI-CONSOLE _____________ - and whether FANSI-CONSOLE is replacing other single feature console utilities as well as the standard IBM-PC console software. Monochrome adapters, and those color graphics adapters which do not require screen memory writing to be delayed until a horizontal retrace, are generally speeded up more than the standard IBM-PC color graphics adapter. The alphanumeric screen modes generally are speeded up more than the graphics screen modes. DOS calls are generally speeded up more than BIOS calls. Programs that require no screen scrolling are speeded up more than those requiring scrolling. The best part is that the screen modes used the most, the alphanumeric modes with no scrolling, are speeded up the most. Some IBM-PC equivalent computer BIOSes are slower than others, and these are speeded up more than the fast ones. Most single feature console utilities have the bad side effect that they slow down the screen writing a bit. The more single feature console utilities you replace FANSI-CONSOLE _____________ with FANSI-CONSOLE, the more your screen writing is speeded up. 1.2.3 Processes more ANSI X3.64 escape sequences _____ _________ ____ ____ _____ ______ _________ 1.2.3 Processes more ANSI X3.64 escape sequences FANSI-CONSOLE _____________ Another important feature is that FANSI-CONSOLE processes American National Standards Institute (ANSI) X3.64 standard escape sequences like the standard IBM-PC DOS 2.00 (and later versions) ANSI.SYS device driver. This standard is a subset of the International FANSI-CONSOLE _____________ ______ _ Standards Organization's standard ISO 6429. FANSI-CONSOLE allows a ____ ______ ______ __ ___ _____ ________ much larger subset of the X3.64 standard to be used than the standard IBM-PC ANSI.SYS device driver does. All escape sequences work in the graphics screen modes as well as in the alphanumeric screen modes. This means programs can do more versatile things with the screen in a simpler and computer independent way. This is directly important to you because such programs can have their screen writing sent to remote terminals, or be redirected to data files. Indirectly, it is important to you, because it has the effect of reducing program development costs. It does this by making it easier to write things to the screen. It also allows the same program to run without change on many different types of computers. Presumably, the program developers will pass the savings on to you. For more information about escape sequences, see the chapter entitled "ANSI X3.64 escape sequences". Note that the chapter describing these escape sequences abbreviated ___________ is not in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. A few demonstration (C) Copyright 1984-85 Hersey Micro Consulting 4 (C) Copyright 1984-85 Hersey Micro Consulting 4 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction files are included on the diskette, though. Using these escape sequences, it is possible to limit the screen writing of some programs to a portion of the screen called a "window" or a "scrolling region". These windows can be scrolled in any direction or otherwise modified without affecting text on the rest of the screen. A program which knows about scrolling regions may use more than one scrolling region to effectively divide the screen display. For more information about scrolling regions, see the description of the ANSI SSR command in the chapter entitled "ANSI X3.64 escape sequences". Note that the chapter describing these abbreviated ___________ escape sequences is not in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. A few files are included on the diskette which give demos, though. 1.2.4 Emulates DEC VT100 _____ ________ ___ _____ 1.2.4 Emulates DEC VT100 FANSI-CONSOLE _____________ FANSI-CONSOLE can make the numeric keypad and function keys emulate a DEC VT100 auxiliary keypad. With the processing of ANSI X3.64 escape sequences, this can make the IBM-PC console look like a DEC VT100 to any application program. This is useful because there are already many good programs written for machines that use the VT100 for a console. The console handling of such programs do not have to be rewritten to allow them to run on an IBM-PC. It also means that simple terminal emulation (communications) programs which use MS(PC)- MODEM86 (tm) _______ ____ DOS console calls, such as our MODEM86 (tm) program, turns your IBM-PC or clone into an ANSI X3.64 standard terminal. For more information about VT100 emulation, see the section entitled "How do I FANSI-CONSOLE _____________ get FANSI-CONSOLE to emulate a VT100?" in the chapter entitled "Advanced Features". FANSI-CONSOLE _____________ FANSI-CONSOLE can also emulate a DEC VT52/Heath H19/Zenith Z100 console as part of its VT100 emulation. For more information about getting into this mode, see the subsection describing the ANSI DEC-SM command in the chapter entitled "ANSI X3.64 escape sequences". 1.2.5 Allows one finger pausing _____ ______ ___ ______ _______ 1.2.5 Allows one finger pausing FANSI-CONSOLE _____________ ______ ___ __ ___ __ ___ ___________ ___ ___ ________ FANSI-CONSOLE allows you to set up the Scroll-Lock key for optional ___ ______ _______ one finger pausing. The Scroll-Lock key may be set up to act as a scroll lock toggle. This is somewhat similar to the Ctrl-Num-Lock key combination you are already familiar with. However, it allows you to typeahead before turning off the scroll lock. With both the FANSI-CONSOLE _____________ Ctrl-Num-Lock and Scroll-Lock pausing, FANSI-CONSOLE prevents the duplicate lines which may appear when using the standard IBM-PC console software. For more information about one finger pausing, see the chapter entitled "Detailed Installation". (C) Copyright 1984-85 Hersey Micro Consulting 5 (C) Copyright 1984-85 Hersey Micro Consulting 5 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.6 Allows recall of lines scrolled off the screen _____ ______ ______ __ _____ ________ ___ ___ ______ 1.2.6 Allows recall of lines scrolled off the screen FANSI-CONSOLE _____________ Another important optional feature of FANSI-CONSOLE is that when you pause with Scroll-Lock, it allows you to see lines which have already left the top of the screen. Such lines would otherwise be gone for good. Now you can even print them. We call this the scroll recall FANSI-CONSOLE _____________ feature. Unlike some scroll recall programs, FANSI-CONSOLE saves the lines in full color, and they may be saved regardless of the current screen display mode. For more information about the scroll recall feature, see the chapter entitled "Detailed Installation" and the section entitled "How do I use the scroll recall feature?" in the chapter entitled "Advanced Features". Note the latter section is not abbreviated ___________ in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. 1.2.7 Allows much more typeahead _____ ______ ____ ____ _________ 1.2.7 Allows much more typeahead FANSI-CONSOLE _____________ FANSI-CONSOLE has a much larger typeahead buffer than the standard IBM-PC console software. Typeahead is what your keystrokes are called when the currently running program is not reading them at the moment. Sometimes the program is busy with a previous command. FANSI- ______ Other times the program just does not require keyboard input. FANSI- CONSOLE _______ CONSOLE allows 255 characters of typeahead. The standard IBM-PC console software allows only 15 characters. This means you are much less likely to get that horrible beep that means your keystrokes are being ignored because the currently running program is busy. The convenience of so much typeahead also brings problems of discovering FANSI-CONSOLE _____________ that you mistyped something early on. So FANSI-CONSOLE also allows _____ ___ _________ ______ you to flush the typeahead buffer with a Ctrl-F without stopping what is currently running. Also Ctrl-C, Ctrl-Break, and Ctrl-S, all flush the typeahead buffer before their normal action. This means you are not ignored when you type these keys just because you happened to have typed ahead something else earlier. For more information about FANSI-CONSOLE _____________ key usage, see the section entitled "How do I use the FANSI-CONSOLE keyboard?". (C) Copyright 1984-85 Hersey Micro Consulting 6 (C) Copyright 1984-85 Hersey Micro Consulting 6 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.8 Allows keyboard macro assignment during running programs _____ ______ ________ _____ __________ ______ _______ ________ 1.2.8 Allows keyboard macro assignment during running programs FANSI-CONSOLE _____________ Like the standard IBM-PC ANSI.SYS device driver, FANSI-CONSOLE allows you to assign keyboard macros to keys. Unlike the standard IBM-PC FANSI-CONSOLE _____________ ANSI.SYS device driver, FANSI-CONSOLE allows you to do this even during a running program. A keyboard macro is a string of characters you assign to a particular key. By pressing that key, you can automatically input a whole string of characters. Using keyboard macros avoids the tedium of typing the same long string of characters more than once. For more information about keyboard macros, see FANSI-CONSOLE _____________ section entitled "How do I assign macros to FANSI-CONSOLE keys?" in the chapter entitled "Advanced Features". Note this chapter is not abbreviated ___________ in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. 1.2.9 Allows more memory for keyboard macros _____ ______ ____ ______ ___ ________ ______ 1.2.9 Allows more memory for keyboard macros More memory is allowed for keyboard macros than the standard IBM-PC FANSI-CONSOLE _____________ ANSI.SYS device driver. FANSI-CONSOLE also allows you to specify how much memory is used for keyboard macros. For more information about memory usage, see the chapter entitled "Detailed Installation". 1.2.10 Turns displays off when not in use ______ _____ ________ ___ ____ ___ __ ___ 1.2.10 Turns displays off when not in use FANSI-CONSOLE _____________ For most display adapters, FANSI-CONSOLE can be configured to automatically turn off your console screen displays when not in use for a specified time. This prevents you from permanently burning a particular display pattern into the phosphors on your screen by FANSI-CONSOLE _____________ leaving it on the display too long. FANSI-CONSOLE turns off both displays, if you have two display adapters. Note that to avoid surprising people, this is not the default action. For more information about the screen save feature, see the chapter entitled "Detailed Installation". 1.2.11 Allows one finger typing ______ ______ ___ ______ ______ 1.2.11 Allows one finger typing FANSI-CONSOLE _____________ ______ ___ __ ___ __ ___ ________ ___ ________ FANSI-CONSOLE allows you to set up the keyboard for optional __________ ______ one-finger typing for the physically handicapped. When combined with the one-finger pausing and scroll recall, the console becomes a much more convenient tool for the physically handicapped. For more information about one finger typing, see the chapter entitled "Detailed Installation". (C) Copyright 1984-85 Hersey Micro Consulting 7 (C) Copyright 1984-85 Hersey Micro Consulting 7 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.12 Allows keyboard generated breakpoints ______ ______ ________ _________ ___________ 1.2.12 Allows keyboard generated breakpoints FANSI-CONSOLE _____________ FANSI-CONSOLE has Alt-Ctrl-Ins set up to generate the equivalent of a breakpoint. This is handy for assembly language programmers, when debugging programs with infinite loops. For more information about keyboard generated breakpoints, see the subsection entitled "Using the Alt-Ctrl-Ins key" in the chapter entitled "Advanced Features". abbreviated ___________ Note this chapter is not in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. 1.2.13 Eliminates screen flicker ______ __________ ______ _______ 1.2.13 Eliminates screen flicker A feature that owners of some IBM-PC color graphics adapter FANSI- ______ equivalents, like Tecmar's Graphics Master, will love is that FANSI- CONSOLE _______ _________ ______ _______ _______ CONSOLE can be used to eliminate screen flicker (blink) as it is scrolled. On these same adaptors, some TopView compatible programs ___ (when not running under Topview) can be made write the screen faster and not blink the screen even if they write the screen memory directly. Unfortunately, this is not so on the standard IBM-PC color __ graphics adapter because of a hardware design deficiency (well, we call it that). To identify these adapters more easily when making purchasing decisions, we have included a program called SNOW which may be used to determine whether an adapter requires that annoying blinking. For more information about eliminating screen flicker, see the chapter entitled "Detailed Installation". 1.2.14 Provides support for 50 line displays ______ ________ _______ ___ __ ____ ________ 1.2.14 Provides support for 50 line displays For display adapters with enough memory and displays with a long persistence phosphor, there is support for several 50 line interlace display modes. For more information about 50 line display modes, see the subsection describing the IBM-SM command in the chapter entitled "ANSI X3.64 Escape Sequences". Note this chapter is not in the abbreviated ___________ abbreviated user manual found on the diskette, but is contained in the complete printed user manual. (C) Copyright 1984-85 Hersey Micro Consulting 8 (C) Copyright 1984-85 Hersey Micro Consulting 8 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.15 Extends the IBM-PC ROM BIOS ______ _______ ___ ______ ___ ____ 1.2.15 Extends the IBM-PC ROM BIOS FANSI- ______ Several additional capabilities have been added to the part of FANSI- CONSOLE _______ CONSOLE which replaces the ROM BIOS. Among other things, it provides additional BIOS capabilities which make your IBM-PC more like an IBM-PC AT (in versatility, if not in speed). For more information about ROM BIOS extensions, see the chapter entitled "ROM BIOS abbreviated ___________ calls". Note this chapter is not in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. 1.2.16 Provides some control over use of color ______ ________ ____ _______ ____ ___ __ _____ 1.2.16 Provides some control over use of color FANSI-CONSOLE _____________ FANSI-CONSOLE provides some control over the use of color by some programs. Many programs use white characters on a black background. FANSI-CONSOLE _____________ For some of these programs, FANSI-CONSOLE allows you to force a different color combination to be used instead. Also, if you have a monochrome display attached to your color graphics adapter, some programs which use colors have displays which are hard to read. FANSI-CONSOLE _____________ FANSI-CONSOLE allows you to force some of these programs to use only black and white characters. For more information about color control, see the chapter entitled "Detailed Installation". 1.2.17 Provides control over key repeat rate ______ ________ _______ ____ ___ ______ ____ 1.2.17 Provides control over key repeat rate FANSI-CONSOLE _____________ FANSI-CONSOLE provides control over the keyboard key repeat rate. The repeat rate may be set faster for more zippy response to your arrow or paging keys, for example. It may also be set slower, if that is required. The delay before the repeating starts may be shortened or lengthened. For more information about the keyboard repeat rate, see the chapter entitled "Changing Options at abbreviated ___________ Run-time". Note this chapter is not in the abbreviated user manual found on the diskette, but is contained in the complete printed user manual. 1.2.18 Other features ______ _____ ________ 1.2.18 Other features FANSI-CONSOLE _____________ FANSI-CONSOLE will have other features which will become documented as they become ready for use. Your distribution diskette has files on it which briefly describe any new features which may have been abbreviated ___________ added since this manual was printed. This includes an abbreviated user manual which is slightly more up to date than the printed user manual, and a history file briefly indicating recent changes. (C) Copyright 1984-85 Hersey Micro Consulting 9 (C) Copyright 1984-85 Hersey Micro Consulting 9 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _________________________________________________________________ 1.3 What about multitasking windowing programs and FANSI-CONSOLE? FANSI-CONSOLE _____________ You may wonder how FANSI-CONSOLE compares with some of the new multitasking windowing programs such as IBM's TopView, Quarterdeck's FANSI-CONSOLE _____________ DESQ, or Microsoft's Windows. FANSI-CONSOLE is not meant to compete directly with these programs. Such programs are called "multitasking" because they allow several programs to be in the middle of doing their respective "tasks" at the same time. A multitasking windowing program manages the screen for such tasks, and allows you to switch between tasks. We want to make it clear that FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE does not handle multitasking. FANSI-CONSOLE may be FANSI-CONSOLE _____________ used with most multitasking windowing programs. FANSI-CONSOLE may not affect them or the programs running under them, since most of these multitasking windowing programs write directly to the screen hardware. There are times, though, when you want to run without the multitasking windowing program, to do things like run batch files or FANSI-CONSOLE _____________ programs with command line parameters. At these times, FANSI-CONSOLE is there to speed up screen writing. FANSI-CONSOLE _____________ We believe that FANSI-CONSOLE is generally a more helpful product for the budget minded customer than multitasking windowing programs. FANSI-CONSOLE _____________ FANSI-CONSOLE offers much less in the way of features than most FANSI-CONSOLE _____________ multitasking windowing programs, but FANSI-CONSOLE uses much less read/write memory and no secondary memory like additional disks, and costs less than most multitasking windowing programs. Multitasking windowing programs usually need much more than 256 KB of read/write memory and a fixed disk for quick execution or sometimes any execution! All this memory is generally used to keep several programs in memory at once as well as copies of their screen displays. Requiring that much memory or fixed disks means that those of you who cannot afford to lay out so much money per workstation are unable to use multitasking windowing programs. Even if you can afford a multitasking windowing program and its FANSI-CONSOLE _____________ required extra hardware, you may find FANSI-CONSOLE more to your FANSI-CONSOLE _____________ liking. FANSI-CONSOLE speeds up the screen writing of many programs to make them quick enough for your tastes. When your favorite FANSI-CONSOLE _____________ application program still takes awhile to do something, FANSI-CONSOLE allows you to keep typing by having a generous typeahead buffer. Most multitasking windowing products do nothing to speed up the screen writing of other programs. They also do not allow you to typeahead much. Many slow things down, even though they claim to be "user-friendly". However, it is generally recognized that being speedy is the most user-friendly quality of a product. (C) Copyright 1984-85 Hersey Micro Consulting 10 (C) Copyright 1984-85 Hersey Micro Consulting 10 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _____________ Another reason to like FANSI-CONSOLE is that once you install it, it ___ does not require separate installation of the programs you run with FANSI-CONSOLE _____________ FANSI-CONSOLE. Most multitasking windowing programs require a sometimes laborious installation process for each program you intend to run with the multitasking windowing program. (C) Copyright 1984-85 Hersey Micro Consulting 11 (C) Copyright 1984-85 Hersey Micro Consulting 11 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly Chapter 2 Chapter 2 Starting Quickly Starting Quickly FANSI-CONSOLE __________________________________________________________ 2.1 Do I have to read the whole FANSI-CONSOLE user manual? 2.1.1 NO! ___ You do not have to read this whole manual from cover to cover to take FANSI-CONSOLE _____________ advantage of FANSI-CONSOLE. You only have to know what is in this ______ chapter to get started. If you want really brief instructions, just ____ read the description of this chapter in the table of contents! We know how much you hate to have to read the manual before trying out a program. Unfortunately, this program can not be menu driven because of its nature. There is an extensive index at the end of this manual. It is there to help you if you have problems finding what you want to know. Please use it, especially if you do not read the manual from cover to cover. For example, solutions to many common problems can be found by looking up the keyword "problem" in the index. If you can not find something where you looked first in the index, let us know! We think the index should be comprehensive. That minimizes the number of calls we get asking about things which are fully explained in the manual but hard to find. There is a section in the chapter entitled "Compatibilities and Limitations" which is devoted to solving compatibility problems with FANSI-CONSOLE _____________ FANSI-CONSOLE. You should read that if you experience problems. If you can not find what you want to know in the abbreviated user manual found on the diskette, then it is probably time to order a complete printed user manual. You can tell this is the case when you find yourself looking for a page number mentioned in the index or table of contents which is not in your abbreviated user manual. The index and the table of contents are complete, but the rest of the ___ abbreviated user manual found on the diskette is not! FANSI-CONSOLE _____________ Lastly, even though it is possible to use FANSI-CONSOLE without reading the chapter on its distribution, please read it, too. It has information which is important to us about what we expect in return FANSI-CONSOLE _____________ from you for your being able to use FANSI-CONSOLE. (C) Copyright 1984-85 Hersey Micro Consulting 12 (C) Copyright 1984-85 Hersey Micro Consulting 12 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FANSI-CONSOLE ___________________________________________ 2.2 How do I quickly install FANSI-CONSOLE? FANSI- ______ The following is the simplest possible setup procedure for FANSI- CONSOLE FANSI-CONSOLE _______ _____________ CONSOLE. Use it if you are in a hurry to try FANSI-CONSOLE. Keep in FANSI-CONSOLE _____________ ___ mind that FANSI-CONSOLE has many features which can not be taken advantage of without more detailed installation. Further reading will allow you to take advantage of those features at a later time. 2.2.1 Verify distribution diskette _____ ______ ____________ ________ 2.2.1 Verify distribution diskette The first step is to verify that the following files are on the distribution diskette: ANSI40.TXT ANSI40.TXT Test data for 40 column screen displays. Chock full of examples of ANSI X3.64 escape sequences. TYPE this file for a demo! ANSI80.TXT ANSI80.TXT Test data for 80 column screen displays. Chock full of examples of ANSI X3.64 escape sequences. TYPE this file for a demo! DEJAVU.EXE DEJAVU.EXE Program which writes the lines from the scroll recall buffer to a file. DIZZY.C DIZZY.C Source for C program which generated part of ANSI80.TXT. DVORAK.TXT DVORAK.TXT Test data to set up a quasi-Dvorak keyboard layout. Unless you know what a Dvorak keyboard layout is, we NOT ___ strongly suggest that you NOT TYPE this file. This is not a real Dvorak layout, but only an example of key redefinition. FCONBETA.DEV FANSI-CONSOLE _____________ FCONBETA.DEV beta test version of FANSI-CONSOLE. This version is less tested than the commercial version and may have more bugs, but it also has never features which you may want to try. FCONSOLE.DEV FANSI-CONSOLE _____________ FCONSOLE.DEV FANSI-CONSOLE itself. This is the commercial version. It is more stable and bugfree than FCONBETA.DEV. The current printed manual describes this version. (C) Copyright 1984-85 Hersey Micro Consulting 13 (C) Copyright 1984-85 Hersey Micro Consulting 13 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FCONSOLE.DQC FANSI-CONSOLE abbreviated _____________ ___________ FCONSOLE.DQC FANSI-CONSOLE abbreviated user manual for beta test version in squeezed form. This file includes FANSI- ______ information about the beta test version of FANSI- CONSOLE _______ CONSOLE which is not yet in the printed user manual. After using UNSQZ to unsqueeze it, PRINT or TYPE the resulting FCONSOLE.DOC file. You are reading a copy of it now! FCONSOLE.HST FCONSOLE.HST Revision history information. This file includes FANSI- ______ information about the latest version of FANSI- CONSOLE _______ CONSOLE which is not yet in the printed user manual. PRINT or TYPE this file. FLAYOUT.EXE FLAYOUT.EXE Program to rearrange your keyboard keys to your liking. RAWMODE.MAC RAWMODE.MAC Source for subroutines which are useful for programmers wishing to speed up their program's screen writing. See the comments in the file for information about on usage. README.NOW abbreviated ___________ README.NOW Short directions for printing the abbreviated user manual. SK111.PCH SK111.PCH Patch for Sidekick to keep it from waking up when Alt-Ctrl is pressed. Use Left-Shift-Right-Shift instead. See the comments in the file for information about usage. SNOW.COM SNOW.COM Test program to help you decide how to set some of FANSI-CONSOLE _____________ the FANSI-CONSOLE hardware options. Simply run the program. See the chapter entitled "Detailed Installation" for information about usage. SPIT.EXE SPIT.EXE Test program for slowly trying test data. Use it to display a file on the console, like the MS(PC)-DOS TYPE command. It waits, with no prompts, for you to press a key between every line displayed. STANDARD.LAY STANDARD.LAY Standard keyboard layout file. For use with FLAYOUT. UNSQZ.COM UNSQZ.COM Program to unsqueeze FCONSOLE.DQC. UNSQZ FCONSOLE.DQC produces FCONSOLE.DOC. WATZITDO.COM WATZITDO.COM Displays the effects of pressing keys. Useful for reporting information to us about nonstandard keyboards. (C) Copyright 1984-85 Hersey Micro Consulting 14 (C) Copyright 1984-85 Hersey Micro Consulting 14 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly WORDSTAR.PCH WORDSTAR.PCH Patch for WordStar to make it write to the screen faster. See the comments in the file for information about usage. If the listed files are not all there, ask whomever you got the program from to give you the missing files. They are supposed to give you all the files listed here. There may be additional optional files on the diskette which are not listed here. Please note that the user manual which appears on this diskette is abbreviated ___________ abbreviated. Chapters describing advanced features in detail are abbreviated ___________ omitted from the abbreviated user manual on the diskette. See the chapter entitled Distribution and Licensing. (C) Copyright 1984-85 Hersey Micro Consulting 15 (C) Copyright 1984-85 Hersey Micro Consulting 15 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.2 Backup distribution diskette _____ ______ ____________ ________ 2.2.2 Backup distribution diskette The second step is to make a backup copy of your distribution diskette using the MS(PC)-DOS DISKCOPY command, as outlined in the MS(PC)-DOS manual. Start out by making sure the distribution diskette is write protected, so you do not accidentally destroy what __ ____ is on the diskette by copying to it instead of copying from it. After all, the reason you should make the backup copy in the first place is to have extra copies if one copy gets accidentally destroyed. 2.2.3 Backup system disks _____ ______ ______ _____ 2.2.3 Backup system disks The third step is to make backup copies of your MS(PC)-DOS 2.00 (or later versions) system diskettes using the MS(PC)-DOS DISKCOPY command, as outlined in the MS(PC)-DOS manual. A system disk is any disk with the MS(PC)-DOS operating system on it. Many MS(PC)-DOS ___ diskettes are NOT system disks. The best way to tell if a diskette is a system disk is to put the diskette into drive A: and restart MS- (PC)-DOS by pressing Alt-Ctrl-Del. If MS(PC)-DOS starts without further changing diskettes, then the diskette is a system disk. If you have a fixed disk and you can start MS(PC)-DOS using Alt-Ctrl-Del without a diskette in drive A:, then your fixed disk is also a system disk. However, it is not necessary to make a backup copy of your FANSI-CONSOLE _____________ fixed disk just to try FANSI-CONSOLE. If your MS(PC)-DOS version is less than 2.00, then run out and buy FANSI-CONSOLE _____________ the latest version now! FANSI-CONSOLE requires at least version 2.00. Many other programs soon will as well. Do not get lost in the past! 2.2.4 Copy FCONSOLE.DEV to system disk _____ ____ ____________ __ ______ ____ 2.2.4 Copy FCONSOLE.DEV to system disk The fourth step is to copy the file FCONSOLE.DEV from our distribution diskette to your MS(PC)-DOS 2.00 (or later) system disks using the MS(PC)-DOS COPY command. Copy FCONSOLE.DEV to the root directory on the system disk. Do this to all your system disks, if you have more than one. However, we suggest that you do them one at a time. Test each one for a few days, or a time period comfortable for you, before installing it on other system disks. If you have a fixed disk, we suggest you try this on a diskette first before FANSI-CONSOLE _____________ installing FANSI-CONSOLE on the fixed disk. All this caution is FANSI-CONSOLE _____________ merely to allow you to start MS(PC)-DOS without FANSI-CONSOLE if there are some problems with it on your computer. (C) Copyright 1984-85 Hersey Micro Consulting 16 (C) Copyright 1984-85 Hersey Micro Consulting 16 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly If you are a bit adventureous, you might want to try FCONBETA.DEV instead of FCONSOLE.DEV. It is our latest beta test version of FANSI-CONSOLE _____________ FANSI-CONSOLE. It may have new features as documented in the FCONSOLE.HST file. However, it may not well debugged, so you are trying it at your own risk. We do not promise to fix bugs which may appear in the beta test version. 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS _____ ___ ___________________ __ __________ 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS The fifth step is to add the line: DEVICE=FCONSOLE.DEV DEVICE=FCONSOLE.DEV to the beginning of the CONFIG.SYS file on your system disk, in the root directory. If there is a CONFIG.SYS file in the root directory on your system disk when you start MS(PC)-DOS, MS(PC)-DOS reads it for special instructions. This is a special instruction to MS(PC)- FANSI-CONSOLE _____________ DOS to install FANSI-CONSOLE when MS(PC)-DOS starts. You must create the CONFIG.SYS file if there is not already one in the root directory on the system disk. Your favorite editor may be used to do this. It is important that the line be at the start of the CONFIG.SYS file instead of the middle or the end. This is mostly because the sooner FANSI-CONSOLE _____________ FANSI-CONSOLE gets loaded and its name banner is displayed, the sooner your larger typeahead buffer is ready to be used. It is also FANSI-CONSOLE _____________ important that FANSI-CONSOLE be loaded before any other device drivers that require keyboard or screen handling, such as mouse device drivers. Otherwise, the position of this line does not matter. The letters may be either upper or lower case. It is important that the "DEVICE=FCONSOLE.DEV" line is ended with a carriage return, and not just with the end of the CONFIG.SYS file. _______ There is a bug in MS(PC)-DOS 2.0 which causes such a line without the carriage return to yield the following strange looking message: Bad or missing FCONSOLE.DEVLE.DEV Bad or missing FCONSOLE.DEVLE.DEV The repeated part of the name is really in the message. This bug was fixed in MS(PC)-DOS 3.0. If you have an IBM-PC clone or if you have non-IBM video card, no matter how equivalent you may believe it to be, you may also need to FANSI-CONSOLE _____________ add some options to this line to tell FANSI-CONSOLE that your PC is FANSI-CONSOLE _____________ different, to get the full functionality of FANSI-CONSOLE. These options are described in the chapter entitled "Detailed Installation". (C) Copyright 1984-85 Hersey Micro Consulting 17 (C) Copyright 1984-85 Hersey Micro Consulting 17 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS _____ ______ _______________ ____ __________ 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS The sixth step is to delete any lines like: DEVICE=ANSI.SYS DEVICE=ANSI.SYS from the CONFIG.SYS file. If you have a line like this referring to another console driver, such as the IBM-PC ANSI.SYS device driver, in the CONFIG.SYS file then you should remove it. This is because FANSI-CONSOLE _____________ FANSI-CONSOLE is a replacement for ANSI.SYS as well as the part of the standard IBM-PC ROM BIOS that deals with the console. They both have the name "CON:" when used later with other MS(PC)-DOS commands. FANSI-CONSOLE _____________ There is no point in trying to make them coexist. FANSI-CONSOLE has all the function of the ANSI.SYS device driver and more. Please note that it is only console drivers that do not work with FANSI-CONSOLE _____________ FANSI-CONSOLE. Device drivers for devices other than the console FANSI-CONSOLE _____________ (CON:) may be used with FANSI-CONSOLE. Such drivers include FANSI- ______ read/write memory-based diskette emulators (RAM-disk) like FANSI- RAMDISK (tm) _______ ____ RAMDISK (tm) and mouse device drivers. So most lines which start with: DEVICE= DEVICE= do not need to be deleted from CONFIG.SYS. If you happen to load both console drivers, the one which is loaded last is the one which is really used as the MS(PC)-DOS console driver. It has either of two bad effects, depending upon which driver is specified first in CONFIG.SYS. If ANSI.SYS is loaded FANSI-CONSOLE _____________ first, ANSI.SYS consumes memory to no effect, since FANSI-CONSOLE is FANSI-CONSOLE _____________ used instead of ANSI.SYS. If FANSI-CONSOLE is loaded first, the MS- FANSI-CONSOLE _____________ (PC)-DOS console driver part of FANSI-CONSOLE is not used. Instead ANSI.SYS is used as the MS(PC)-DOS console driver. However, the BIOS FANSI-CONSOLE _____________ calls are now calls to FANSI-CONSOLE. (C) Copyright 1984-85 Hersey Micro Consulting 18 (C) Copyright 1984-85 Hersey Micro Consulting 18 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.7 Restart MS(PC)-DOS _____ _______ __________ 2.2.7 Restart MS(PC)-DOS _______ __________ The seventh and last step is to restart MS(PC)-DOS. Now that you have changed your CONFIG.SYS file, all you do is use that system disk when you turn on the computer or when you press the Alt-Ctrl-Del key combination. Of course, you could have several system disks with both FCONSOLE.DEV and CONFIG.SYS on it. Any one of them will do. ___ You do not need to have these files on a disk which is on line after FANSI- ______ the MS(PC)-DOS operating system is loaded at the start. FANSI- CONSOLE _______ CONSOLE remains loaded in memory as part of the MS(PC)-DOS operating system until the next time you restart MS(PC)-DOS. FANSI-CONSOLE _____________ You can tell that FANSI-CONSOLE is installed when you see the single line banner with the name of the program and our copyright message at the top of your screen when you start. If you do not see the banner FANSI-CONSOLE _____________ when you start, FANSI-CONSOLE is not installed. It is as simple as that! In either case, the old familiar MS(PC)-DOS prompt appears after your AUTOEXEC.BAT file is completed. Notice that we do not beat you over the head with a full screen request for payment of the usage royalty, like some programs do. We just do that in the user manual! (C) Copyright 1984-85 Hersey Micro Consulting 19 (C) Copyright 1984-85 Hersey Micro Consulting 19 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.8 Add BUFFERS=20 to CONFIG.SYS _____ ___ __________ __ __________ 2.2.8 Add BUFFERS=20 to CONFIG.SYS Although it is not usually necessary, you may also want to add something like the following line to the CONFIG.SYS file on your system disk: BUFFERS=20 BUFFERS=20 The letters may be either upper or lower case. It is not important to place this line in any particular place in the CONFIG.SYS file. The purpose of this command is to allow more buffer space for MS(PC)- DOS to use for reading and writing files. Although this has nothing FANSI-CONSOLE _____________ to do with FANSI-CONSOLE, it also speeds up your computer by speeding up your file accesses. We mention it here because many people are unaware of it. The only negative aspect to using this line in your CONFIG.SYS file is that it consumes about 10 KB of read/write memory for extra buffer space which is no longer usable by your application programs. However, you may replace the number 20 with a smaller number, even one as small as 5. It still speeds up your disk access, although not as much. The space required is proportional to the number used. Using a larger number may help more if you have a large or full fixed disk. If the number is too large, it starts slowing the computer down again. Only you can find the best number for your computer, but almost any number is better than the 2 you get by default. FANSI-CONSOLE _____________ Sometimes, after installing FANSI-CONSOLE, the MS(PC)-DOS FORMAT command refuses to format disks. This problem is caused by a bug in the FORMAT command. The bug causes FORMAT to be sensitive to where it is loaded in memory. Particular FORMAT buffers must not not cross 64 KB byte boundaries. FORMAT is not insuring that they are so arranged. So you must do the arranging yourself. If this bug causes you a problem, the easiest solution is to slightly increase the number in the BUFFERS command and then restart MS(PC)-DOS. If you are already using the BUFFERS limit of 99, then slightly decrease the number. Keep changing the number in the same direction until FORMAT works correctly. (C) Copyright 1984-85 Hersey Micro Consulting 20 (C) Copyright 1984-85 Hersey Micro Consulting 20 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.9 Modify Prompt _____ ______ ______ 2.2.9 Modify Prompt Although it is not necessary, you may want to add something like the following line to the AUTOEXEC.BAT file on your system disk: PROMPT $e\$e[2;37;40m$e[J$n$g PROMPT $e\$e[2;37;40m$e[J$n$g Note that upper and lower case letters must be used exactly as indicated in the prompt. Also, if you use any extra spaces here, you will get extra spaces in your MS(PC)-DOS prompt. This is a MS(PC)- DOS internal command that describes the prompt that MS(PC)-DOS should use when it is ready for a new command. In this example, we have it send out an ANSI X3.64 SGR escape sequence (indicated by the "$e[2;37;40m") to set the current screen colors and other attributes to the normal values (low intensity white foreground on a black background) before displaying the current drive letter ($n) and a greater than symbol ($g). We also send out an ANSI X3.64 erase in display escape sequence ($e[J) to erase the rest of the screen in the current colors (again low intensity white foreground on a black background). We recommend this because some programs leave the current screen color attributes in undesired states. If the screen erasing is not done, you may find that even though what you type is the right color, and the rest of the screen is black, the cursor is a different color. The "$e\" is a string terminator sequence. It terminates any escape sequence string which may be left unfinished by an aborted program. You may find a different set of colors or attributes desirable. You may also want the MS(PC)-DOS prompt to use different colors or have different attributes than what you type after it. So you may want to use different ANSI X3.64 SGR commands, like the following: PROMPT $e\$e[2;32;40m$e[J$e[1;36m$n$g$e[2;32m PROMPT $e\$e[2;32;40m$e[J$e[1;36m$n$g$e[2;32m This prompt erases the screen with a green foreground on a black background, displays the current drive and a greater than symbol in a cyan foreground on a black background, and insures that command characters you type appear with a green foreground on a black background. You can create a more elaborate prompt of your own choosing by using more complicated ANSI X3.64 escape sequences (described in the chapter entitled "ANSI X3.64 Escape Sequences" not ___ which is not in the abbreviated user manual) and other PROMPT command options. (C) Copyright 1984-85 Hersey Micro Consulting 21 (C) Copyright 1984-85 Hersey Micro Consulting 21 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly However, using a prompt like this does have some small side effects, which you should note. 1. The PROMPT only resets the foreground and background colors after every MS(PC)-DOS command, when the MS(PC)-DOS ECHO is ON. If ECHO is OFF, it has no effect. 2. The PROMPT resets the foreground and background colors after _____ every MS(PC)-DOS command, when the MS(PC)-DOS ECHO is on. This means that you are not be able to change the colors without changing the PROMPT, since it resets them again immediately afterwards. So you may want to experiment with different ______ colors before setting up this PROMPT. 3. MS(PC)-DOS apparently counts the prompt characters, except the escape. When you use this prompt and you type the line-delete character (ESC for PC-DOS and Ctrl-X for MS-DOS) to restart a line that you are typing at the MS(PC)-DOS prompt, MS(PC)-DOS spaces over too far for the new line. It does not realize that these prompt characters do not all really appear on the screen. 4. When you use this prompt and you type the echo-console-onto-printer character (Ctrl-PrtSc for PC-DOS and Ctrl-P for MS-DOS), prompts do not appear the same as they do on the screen. This is because your printer does not understand ANSI X3.64 escape sequences. 5. When you include an erase in display command as part of your prompt, there is a small delay when the erasing is done before the printed part of your prompt appears. The closer the prompt is to the top of the display, the longer the delay. This is more noticeable with some display adapters (those requiring the /H=1 option) than others. 6. You may run out of MS(PC)-DOS environment space if your prompt is long enough. If you are using MS(PC)-DOS 3.00 you can add /E:xx to the CONFIG.SYS SHELL command to enlarge your environment space. A sample SHELL command would be SHELL=\COMMAND.COM /E:20 /P "SHELL=\COMMAND.COM /E:20 /P". (C) Copyright 1984-85 Hersey Micro Consulting 22 (C) Copyright 1984-85 Hersey Micro Consulting 22 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.10 Leave enough memory for applications programs ______ _____ ______ ______ ___ ____________ ________ 2.2.10 Leave enough memory for applications programs FANSI-CONSOLE _____________ Although, FANSI-CONSOLE does not require much memory for itself, it does require some. If you have made ram-disks or print spoolers consume all the extra memory you had before, then you need to adjust these programs to use a bit less. You need to have about the same amount of memory left over for applications programs as you did before. Otherwise programs run out of room because you have left too little for them. Sometimes a program does not complain directly about having less memory, instead it starts doing more file accesses than before. It may do this either to load and reload overlays or to spill large amounts of data into and out of a temporary file. This even happens on computers fully loaded with memory. Remember, what counts is not the total memory you have, but how much of it you have left for the applications programs. To find out how much memory is left over for applications programs, use the MS(PC)-DOS CHKDSK command. The last line printed is the amount of memory usable by applications programs. We can not tell you exactly how much you need, since it depends on what programs you run. However, nearly everyone should leave at least 128 KB. FANSI-CONSOLE _____________ For more information about the memory requirements of FANSI-CONSOLE, FANSI-CONSOLE _____________ see the section entitled "How much memory does FANSI-CONSOLE require?" in the chapter entitled "Detailed Installation". (C) Copyright 1984-85 Hersey Micro Consulting 23 (C) Copyright 1984-85 Hersey Micro Consulting 23 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FANSI-CONSOLE _______________________________ 2.3 How do I use FANSI-CONSOLE? FANSI-CONSOLE _____________ Now that you have FANSI-CONSOLE installed, you just proceed as you FANSI-CONSOLE _____________ always do, and mostly ignore that FANSI-CONSOLE is loaded and FANSI-CONSOLE _____________ running. When the FANSI-CONSOLE banner appears at the top of your screen when you start MS(PC)-DOS, many programs magically write to the screen faster without your further intervention. All you must do now is appreciate our efforts! As noted before, you may want to use the typeahead buffer more than before. You may also want to take advantage of the new special keys described here. Some more useful features are described in the chapters entitled "Detailed Installation" and "Advanced Features", but you do not need to rush to those chapters yet. 2.3.1 Using the Ctrl-F key Press the Ctrl-F key to simply flush (empty) the typeahead buffer. The Ctrl-F is left in the buffer, but many programs ignore it or do something harmless. If you find an application that does something dangerous with the Ctrl-F key, you may want to try the Ctrl-S key instead. 2.3.2 Using the Ctrl-S key Press the Ctrl-S key to flush the typeahead buffer and, if the current program uses Ctrl-S as a pause key, cause the current program to pause. Most programs pay attention to this key and pause. Otherwise they probably ignore it. The standard IBM-PC console software processes the Ctrl-S slightly differently, by not flushing the typeahead buffer when a Ctrl-S is pressed. This means that the standard IBM-PC console software ignores the Ctrl-S character if you already have some characters in the typeahead buffer. For other ways to pause, see the description of the Ctrl-Num-Lock key in the next paragraph and of the /L=1 option in the chapter entitled "Detailed Installation". (C) Copyright 1984-85 Hersey Micro Consulting 24 (C) Copyright 1984-85 Hersey Micro Consulting 24 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.3.3 Using the Ctrl-Num-Lock key Press the Ctrl-Num-Lock key to cause the display to pause without FANSI-CONSOLE _____________ flushing the typeahead buffer. With FANSI-CONSOLE this key combination works in a manner similar to the way it works with the standard IBM-PC console software. One advantage, however, is that FANSI-CONSOLE _____________ unlike the standard IBM-PC console software, FANSI-CONSOLE prevents the appearance of duplicate lines during a pause. Press any other key combination to unlock the pause. Unless the second key combination is a Ctrl-Break or a Ctrl-C, it is ignored other than for FANSI-CONSOLE _____________ clearing the pause. Any program that works with FANSI-CONSOLE pauses with Ctrl-Num-Lock. For other ways to pause, see the description of the Ctrl-S in the previous paragraph and of the /L=1 option in the chapter entitled "Detailed Installation". 2.3.4 Using the Ctrl-C or Ctrl-Break keys Press the Ctrl-C key to cancel most programs. It is treated by FANSI-CONSOLE _____________ FANSI-CONSOLE as equivalent to the Ctrl-Break key. Both keys are treated the same way as the standard IBM-PC console software treats the Ctrl-Break key, which is to flush the typeahead buffer before placing a Ctrl-C in it. The standard IBM-PC console software processes the Ctrl-C slightly differently, by not flushing the typeahead buffer when a Ctrl-C is pressed. This means that the standard IBM-PC console software ignores the standard MS(PC)-DOS Ctrl-C cancel character when you already have some characters in the typeahead buffer. Pressing Ctrl-C does not cancel any program that Ctrl-Break does not cancel when using the standard IBM-PC console software. (C) Copyright 1984-85 Hersey Micro Consulting 25 (C) Copyright 1984-85 Hersey Micro Consulting 25 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FANSI-CONSOLE _____________________________________ 2.4 How do I uninstall FANSI-CONSOLE? If you ever find that you need to use another application program FANSI-CONSOLE _____________ without having FANSI-CONSOLE installed, because of incompatibility or other reasons, it is just as easy to uninstall as it is to install. The easiest way is to start MS(PC)-DOS using a system disk on which FANSI-CONSOLE _____________ FANSI-CONSOLE is not installed. Another way is to simply remove the "DEVICE=FCONSOLE.DEV" line from the CONFIG.SYS file on your normal system disk. If it is the only FANSI-CONSOLE _____________ line in CONFIG.SYS, then FANSI-CONSOLE may also be uninstalled by deleting or renaming CONFIG.SYS to another name like CONFIG.TMP. Once the line is removed from CONFIG.SYS, or CONFIG.SYS is removed or renamed, you must restart MS(PC)-DOS. This may be done by pressing Alt-Ctrl-Del or by turning your computer off and then on. Simply removing the FCONSOLE.DEV file from your system disk, or FANSI-CONSOLE _____________ renaming it, and restarting MS(PC)-DOS also uninstalls FANSI-CONSOLE, but it causes the following error message to be displayed by MS(PC)- DOS when it starts: Bad or missing FCONSOLE.DEV Bad or missing FCONSOLE.DEV FANSI-CONSOLE _____________ If you are uninstalling FANSI-CONSOLE, and you have set your MS(PC)- DOS prompt to use ANSI X3.64 escape sequences codes, you probably want to replace the "DEVICE=FCONSOLE.DEV" line in the CONFIG.SYS file with a line containing "DEVICE=ANSI.SYS", or at least change your prompt again. (C) Copyright 1984-85 Hersey Micro Consulting 26 (C) Copyright 1984-85 Hersey Micro Consulting 26 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Chapter 3 Chapter 3 Detailed Installation Detailed Installation ___________________________________________________ 3.1 So what is an MS(PC)-DOS device driver, anyway? Now we describe some features of MS(PC)-DOS that the IBM-PC DOS manuals do not describe well. The IBM-PC DOS manuals describe some but not all these features. It is definitely hard to find those features which the manuals do describe. IBM has even moved most of this information to a separately purchased manual called the DOS Technical Reference Manual. We feel you will find it useful to know FANSI-CONSOLE _____________ these features to understand what FANSI-CONSOLE is and how it works. MS(PC)-DOS has provision for people other than IBM or Microsoft to write something called a "loadable device driver". A loadable device driver is Microsoft's excellent answer to the problems that many IBM-PC compatible add-on hardware manufactures had with MS(PC)-DOS 1.xx. The problem was that the add-on manufacturers wanted to make their new pieces of hardware work in your computer as though it was really an integral part of the original IBM-PC. To do this, the add-on manufacturers had to create software for their hardware and make it look like part of the original MS(PC)-DOS. However, they were not given the source program for MS(PC)-DOS, nor were they given a standard way to write their software and have MS(PC)-DOS include this software into itself as it started up. So everyone started disassembling the operating system and making some very ugly programs that patched themselves into the operating system in whatever ways they could figure out. Using two of these programs for two different pieces of add-on hardware would almost invariably cause conflicts and they would not work together. Furthermore, the programs would not work with newer versions of MS(PC)-DOS, if for no other reason than that the MS(PC)-DOS internal program variable addresses would change. (C) Copyright 1984-85 Hersey Micro Consulting 27 (C) Copyright 1984-85 Hersey Micro Consulting 27 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Microsoft solved this by allowing add-on hardware manufacturers to write programs called loadable device drivers to control their hardware ("drive their devices") by following a standard form which Microsoft specified. MS(PC)-DOS loads these device drivers at start up time similarly to the original device drivers that come with MS- (PC)-DOS from your original manufacturer (IBM or your clone maker). This is a new feature of MS(PC)-DOS 2.00 and later versions. Now all the add-on hardware manufacturers must do is to give you a driver program in a regular MS(PC)-DOS file, and tell you how to include it in your operating system as you start up. IBM even gives two loadable device drivers themselves. One is a console driver called ANSI.SYS and was given in object form. The other was a read/write memory based diskette emulation (ram-disk) which was given as a listing (source form) in the MS(PC)-DOS manual for version 2.0. In version 3.0 they included a similar program in object form called VDISK.SYS. Besides allowing the add-on hardware manufacturers to create driver programs for their hardware, the loadable device drivers can also be used to change the behavior of devices which MS(PC)-DOS already FANSI-CONSOLE _____________ supports. That is exactly what FANSI-CONSOLE is all about! The best part is how you incorporate loadable device drivers into MS- (PC)-DOS. All you must do is create a file called CONFIG.SYS with a few commands in it. MS(PC)-DOS always reads this file, if your system disk has one, when it starts and it executes these commands before it does anything else. It does this even before doing the AUTOEXEC.BAT file. Because of the nature of these commands, they may only be done in the CONFIG.SYS file and nowhere else. The command to load a loadable device driver is: DEVICE=<driver file name> <options> DEVICE=<driver file name> <options> The <driver file name> part is the MS(PC)-DOS file name of the device driver. If the driver is in a directory other than the root directory, the complete path name must be used. What the <options> part looks like is entirely up to your device driver authors (that's us!). So it looks like whatever they decide. It may look different for different device drivers. Often <options> are unnecessary. The order of the DEVICE commands determines which is loaded first. If two drivers have the same name, like CON: which is the name of the MS(PC)-DOS console driver, the one which is loaded last is the one used. (C) Copyright 1984-85 Hersey Micro Consulting 28 (C) Copyright 1984-85 Hersey Micro Consulting 28 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation _______________________________________ 3.2 What if my needs are ... different? FANSI-CONSOLE _____________ FANSI-CONSOLE has many installation options. They all have default FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ values which FANSI-CONSOLE sets so that FANSI-CONSOLE is as similar to the standard IBM-PC console software as possible. This means, for example, that the options which specify hardware dependent values, have defaults that match the needs of the standard IBM-PC display FANSI-CONSOLE _____________ adapters. So, by default, FANSI-CONSOLE should work on all "equivalent" computers and adapters. However, if you do not have a FANSI-CONSOLE _____________ ______ standard IBM-PC display adapter, FANSI-CONSOLE probably works better if you change the option values. Also, you may use many of the options to select behavior which you like more than the behavior of the standard IBM-PC console software. You do not need to be a technical genius to figure out how to set the options for your computer. It just takes some reading, some thought, and a few minutes time. It only needs to be figured out once, unless you change your needs by, for example, changing your display adapter. You will probably find that it is worth the effort. Do not worry. You can not hurt your computer by experimenting and trying out different option settings, even if they turn out to be wrong for your display adapter. The worst thing that could happen is that you may need to start the installation process over again. Sometimes the description for an option refers to other sections of this user manual. If you are unsure about how you want to set that option after reading the description, you may want to read the other sections before deciding. Again, do not worry. You can always change your choice later. The options are set by "parameter switches" which you add to the end of the MS(PC)-DOS configuration command in the CONFIG.SYS file. Each option takes the form of an arbitrary number of spaces followed by one slash (or a minus sign, if you prefer) a letter, an equal sign, FANSI-CONSOLE _____________ and a number. If the number starts with a zero, FANSI-CONSOLE FANSI-CONSOLE _____________ considers it a hexadecimal number. Otherwise FANSI-CONSOLE considers it a decimal number. The letter tells which option you are setting and the number specifies the value of the option. It does not matter which case (upper or lower) letters you use. An example is: DEVICE=FCONSOLE.DEV /G=400 /S=10000 DEVICE=FCONSOLE.DEV /G=400 /S=10000 (C) Copyright 1984-85 Hersey Micro Consulting 29 (C) Copyright 1984-85 Hersey Micro Consulting 29 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation We use many spaces between options in this manual, only for clarity. You may use as many spaces as you like, or even no spaces. The one exception is that there must be at least one space after the FCONSOLE.DEV file name, if you specify any options. MS(PC)-DOS requires this space. Otherwise it could not tell that the options FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ are not part of the FANSI-CONSOLE file name. FANSI-CONSOLE processes the options in a left to right order, so if you specify an option FANSI-CONSOLE _____________ more than once, FANSI-CONSOLE uses only the rightmost instance. The option letters and their meanings are as follows: A - Attributes B - Blink C - Color What You Can D - Double Scan Characters F - Font Table Address G - Ctrl-G Bell Length H - Horizontal Retrace Delay I - Initialize with Internal Controller parameters J - Just DOS Keyboard Macros K - Keyboard Language L - Lock on Scroll-Lock M - Macro Memory Allocated N - No Color Display O - One Finger Typing P - Page Overlap R - Recall Line Maximum S - Screen Save Timeout T - TTY ROM BIOS Calls Use ANSI X3.64 V - Vertical Retrace Delay W - Word Wide Screen Move X - Extended Features Y - Yuck, You Should Be So Compatible The following subsections describe each option in detail. The chapter entitled "Compatibility and Limitations" indicates appropriate option selections for various hardware configurations, when they differ from the defaults. (C) Copyright 1984-85 Hersey Micro Consulting 30 (C) Copyright 1984-85 Hersey Micro Consulting 30 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation A - Attributes _ __________ A - Attributes FANSI-CONSOLE _____________ This option specifies the response that FANSI-CONSOLE should give to the ANSI X3.64 Device Attributes (DA) command. Setting this option is only important if you have a program expecting to write to a particular ANSI X3.64 terminal, and it wants the exact response for FANSI-CONSOLE _____________ the particular terminal from the DA command. FANSI-CONSOLE treats this option as a two byte number. The high byte specifies the first value returned. The low byte specifies the second value returned. This is easiest to understand when you specify a hexadecimal number, FANSI- ______ by using a leading zero. So for example, /A=00100 makes FANSI- CONSOLE _______ CONSOLE return ESC [ ? 01 ; 00 c, which is the response for a DEC VT101 terminal. The default is /A=00000. This may be changed if we get an official implementation number. For more information about the Device Attributes command, see the chapter entitled "ANSI X3.64 Escape Sequences". B - Blink _ _____ B - Blink FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should blink the video display on and off when scrolling the color display in the 25x80 alphanumeric screen display mode. It has no effect on the scrolling FANSI-CONSOLE _____________ unless you also use /H=1. Using /B=1 means FANSI-CONSOLE should FANSI-CONSOLE FANSI- _____________ ______ blink. Using /B=0 means FANSI-CONSOLE should not blink. FANSI- CONSOLE _______ CONSOLE ignores other values. Blinking the screen during scrolling allows the use of a faster scrolling routine that would otherwise cause "snow" on adapters requiring /H=1. This snow is also known as hashing. If /H=1 must be used, we recommend using /B=1 (unless /W=1) because otherwise the scrolling is too slow. The drawback to blinking is that it is somewhat hard on the eyes. However, this is what the standard IBM-PC console software does, so it appears "normal". The default value is /B=1, because the IBM-PC color graphics adapter requires /H=1. Specifying a /X value may effect the default setting of /B. You must use /B=0 for color graphics adapters which do not blink when used with the normal IBM-PC software, unless you must also use a /X option with your computer. Otherwise the screen save feature (/S option) does not work properly. Related options are /H, /S, /V, /W, and /X. For the IBM-PC color graphics adapter, we recommend /B=1. (C) Copyright 1984-85 Hersey Micro Consulting 31 (C) Copyright 1984-85 Hersey Micro Consulting 31 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation C - Color What You Can _ _____ ____ ___ ___ C - Color What You Can This option gives the starting value for the FANSI-COLOR mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /C=1 means FANSI-CONSOLE sets FANSI-COLOR at the FANSI-CONSOLE _____________ start. Using /C=0 means FANSI-CONSOLE resets FANSI-COLOR at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. If you use /C=1, many programs which would display only white characters on a black background with /C=0, instead display characters in the current colors and attributes set by the last ANSI X3.64 SGR command. This would normally be the colors and attributes set by the MS(PC)-DOS PROMPT command. The default value is /C=0, because this is the IBM-PC compatible setting. We generally suggest /C=1, because it makes many programs use the colors you prefer instead of white on FANSI-CONSOLE _____________ black. However, if you insist that FANSI-CONSOLE colors things the ____ same way as the standard IBM-PC console software, then you must use /C=0. For more information about the FANSI-COLOR mode, see the description in the chapter entitled "Changing Options at Run-time". This option is related to the /N option, which has priority over this option. D - DouBLe SCAN characters _ ______ ____ __________ D - DouBLe SCAN characters This option gives the starting value for the FANSI-DBLSCAN mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /D=1 means FANSI-CONSOLE sets FANSI-DBLSCAN at the FANSI-CONSOLE _____________ start. Using /D=0 means FANSI-CONSOLE resets FANSI-DBLSCAN at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. If you use /D=1, interlace mode is used to double number of scan lines per character. If your monitor does not have a long persistence phospher the screen will flicker. This is a different interlace mode than the 50 line display mode. If you use /D=0, interlace mode is off, as it normally FANSI-CONSOLE _____________ is without FANSI-CONSOLE. The default value is /D=0, because this is the IBM-PC compatible setting. For more information about the FANSI-DBLSCAN mode, see the description in the chapter entitled "Changing Options at Run-time". (C) Copyright 1984-85 Hersey Micro Consulting 32 (C) Copyright 1984-85 Hersey Micro Consulting 32 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation F - Font Table Address _ ____ _____ _______ F - Font Table Address This option specifies the offset in the ROM BIOS segment (F000:) of the normal graphics character set. The default offset is /F=0FA6E (hexadecimal), since this is the address used in the standard IBM-PC console software. If you do not set this option appropriately, then ________ ______ _______ _____ the characters displayed in the graphics screen display modes appear not ___ as strange shapes instead of characters. This is not meant to allow a way to create alternate character sets, but only to specify where the regular graphics character set is in the ROM if you have a non-standard PC. Most people do not need to set this option. This only affects graphics screen display mode characters and not alphanumeric screen display mode characters. Alternate character sets for the graphics screen display modes may be specified in the usual manner. G - Ctrl-G Bell Length _ ______ ____ ______ G - Ctrl-G Bell Length This option specifies the duration of the Ctrl-G bell. You specify the duration as a delay count measured in approximately 1/4000 seconds. This option has been changed to be independent of how fast your IBM-PC or clone runs. The default is /G=4096 because it is the amount of time used by the standard IBM-PC console software (about one second). If you like your bell a bit shorter, we suggest the bell given by /G=400. Specifying /G=0 turns off the Ctrl-G bell entirely. This is the starting value for FANSI-BELL. It may be changed later using the FANSI-SOV escape sequence. (C) Copyright 1984-85 Hersey Micro Consulting 33 (C) Copyright 1984-85 Hersey Micro Consulting 33 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation H - Horizontal Retrace Delay _ __________ _______ _____ H - Horizontal Retrace Delay FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE must wait for the horizontal retrace signal on color graphics adapters before writing to screen memory in the 25x80 alphanumeric screen display modes. It has no effect for monochrome display adapters or on an EGA. Using FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ /H=1 means FANSI-CONSOLE must delay. Using /H=0 means FANSI-CONSOLE FANSI-CONSOLE _____________ need not delay. FANSI-CONSOLE ignores other values. The default value is /H=1, because the IBM-PC color graphics adapter requires FANSI-CONSOLE _____________ this delay or else "snow" appears when FANSI-CONSOLE writes to the screen. This snow is also known as hashing. You may not mind this, but most people do. If your add-on manufacture's color graphics adapter does not require a delay, then using /H=0 gives a much nicer and faster screen display. The chapter entitled "Compatibility and Limitations" indicates those display adapters for which /H=0 is appropriate. In addition, we have a test program called SNOW. Just run SNOW, and you will see which way to set the /H option. If you can test a display adapter before making a buying decision, we strongly suggest that you not buy one on which SNOW generates snow! For the IBM-PC color graphics adapter, we recommend /H=1. For a Tecmar Graphics Master, use /H=0. For Compaq's or Zenith 150's, use /H=0. Specifying a /X value may effect the default setting of /H. Related options are /B, /V, /W, and /X. I - Initialize with Internal Controller Parameters _ __________ ____ ________ __________ __________ I - Initialize with Internal Controller Parameters The option is the letter I FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use its own internal parameter values for initializing the CRT controller. Using FANSI-CONSOLE _____________ /I=0 means FANSI-CONSOLE should use the table given by the standard FANSI-CONSOLE _____________ IBM-PC console software. Using /I=n means FANSI-CONSOLE should use FANSI-CONSOLE _____________ its internal table number n. Currently, FANSI-CONSOLE has three (3) internal tables. An internal table should be used if you want to give your own starting values which are different from those given by the standard IBM-PC console software. To find the internal tables in FANSI-CONSOLE _____________ a specific version of FANSI-CONSOLE, so that you may change the values, you must specify /I=1 and examine interrupt vector 01D hex. The other tables follow immediately afterwards, in address increments of 40 hex. Generally, we recommend that you do not use /I=n, unless you are an advanced user. So the default value is /I=0. (C) Copyright 1984-85 Hersey Micro Consulting 34 (C) Copyright 1984-85 Hersey Micro Consulting 34 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation J - Just DOS Keyboard Macros _ ____ ___ ________ ______ J - Just DOS Keyboard Macros This option gives the starting value for the FANSI-JUSTDOS mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /J=1 means FANSI-CONSOLE sets FANSI-JUSTDOS at the FANSI-CONSOLE _____________ start. Using /J=0 means FANSI-CONSOLE resets FANSI-JUSTDOS at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. If you use /J=1, keyboard macros are only enabled for MS(PC)-DOS calls and not for BIOS calls. If you use /J=0, keyboard macros are enabled for both MS(PC)-DOS calls and BIOS calls. The default value is /J=1, because this is the IBM-PC compatible setting. For more information about the FANSI-JUSTDOS mode, see the description in the chapter entitled "Changing Options at Run-time". K - Keyboard Language _ ________ ________ K - Keyboard Language This option specifies the keyboard language to be used, as follows: /K=0 means use the USA (US) keyboard. /K=1 means use the French (FR) keyboard. /K=2 means use the German (GR) keyboard. /K=3 means use the Italian (IT) keyboard. /K=4 means use the Spanish (SP) keyboard. /K=5 means use the United Kingdom (UK) keyboard. The default value is /K=0 because that the IBM-PC compatible option. This is the starting value for FANSI-LANGUAGE. It may be changed later using the FANSI-SOV escape sequence, or using the Alt-Ctrl-F1 and Alt-Ctrl-F2 keys. This option is not implemented at this time! (C) Copyright 1984-85 Hersey Micro Consulting 35 (C) Copyright 1984-85 Hersey Micro Consulting 35 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation L - Lock on Scroll Lock _ ____ __ ______ ____ L - Lock on Scroll Lock This option gives the starting value for the FANSI-LOCK mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /L=1 means FANSI-CONSOLE sets FANSI-LOCK at the FANSI-CONSOLE _____________ start. Using /L=0 means FANSI-CONSOLE resets FANSI-LOCK at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. This option specifies whether to have a one-finger pause key. If you use /L=1, Scroll-Lock (or Hold on the Tandy 1000) is the one finger pause key and it FANSI- ______ activates scroll recall feature if enabled. If you use /L=0, FANSI- CONSOLE _______ CONSOLE does not have a one-finger pause key and Alt-Scroll-Lock activates the scroll recall feature if enabled. The default value is /L=0, because this is the IBM-PC compatible setting. To use the one-finger pause key when /L=1 is used, press the Scroll- Lock key to cause the display to pause without flushing the typeahead buffer. This key stroke combination works slightly differently than the Ctrl-Num-Lock combination. Unlike Ctrl-Num-Lock, Scroll-Lock acts as a toggle. When the Scroll-Lock pause is on and the scroll recall feature is disabled, other keys may be used to type ahead without affecting the pause. If the scroll recall feature is enabled, then scroll recall may be done when the Scroll-Lock is on. Pressing Scroll-Lock a second time clears the pause. You will probably find Scroll-Lock more convenient than Ctrl-Num-Lock, mostly because it is a "one finger" pause key. Any program that works with FANSI-CONSOLE _____________ FANSI-CONSOLE pauses with Scroll-Lock. Pressing the Scroll-Lock key with the Alt key, when /L=1 is used, has the same effect as Scroll- Lock does when /L=0 is used. In other words, it sets the scroll lock bit for use by the application programs, such as Borland's Sidekick. For other ways to pause, see the descriptions of Ctrl-S and Ctrl-Num- Lock in the chapter entitled "Starting Quickly". If you use /L=0, this type of pausing may still be done using the Alt-Scroll-Lock key combination instead of Scroll-Lock. Of course, it is then a two finger pause! For more information about the FANSI-LOCK mode, see the description in the chapter entitled "Changing Options at Run-time". For more information about the scroll recall feature, see the description in the chapter entitled "Advanced Features". Related options are /P, and /R. (C) Copyright 1984-85 Hersey Micro Consulting 36 (C) Copyright 1984-85 Hersey Micro Consulting 36 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation M - Macro Memory Allocated _ _____ ______ _________ M - Macro Memory Allocated This option specifies how much read/write memory to reserve for FANSI-CONSOLE _____________ varying space requirements. FANSI-CONSOLE uses this memory for saving ANSI X3.64 command parameters and keyboard macro strings. To estimate your requirements, add your total keyboard macro string lengths to twice the length of your longest keyboard macro. The length of a keyboard macro string is the number of characters which get entered when you press the key. Then add 100 and multiply by 1.25. Remember that this is only an estimate. You may be able to do with less space. The value to specify is measured in bytes. The default and minimum value is /M=512. The maximum value is about FANSI-CONSOLE _____________ /M=40000. If the value is out of range, the FANSI-CONSOLE uses the appropriate limit instead. For more information about keyboard macros, see the section entitled FANSI-CONSOLE _____________ "How do I assign strings to FANSI-CONSOLE keys?" in the chapter entitled "Advanced Features". N - No Color Display _ __ _____ _______ N - No Color Display This option gives the starting value for the FANSI-NOCOLOR mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /N=1 means FANSI-CONSOLE sets FANSI-NOCOLOR at the FANSI-CONSOLE _____________ start. Using /N=0 means FANSI-CONSOLE resets FANSI-NOCOLOR at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. If you use /N=1, some programs which would use color with /N=0, instead display characters in black and white. Programs which write directly to the screen memory are not affected. The default value is /N=0, because this is the IBM-PC compatible setting. We generally suggest /N=0, unless you have a monochrome display connected to a color display adapter and you find that some colored characters are not readable on your display. For more information about the FANSI-NOCOLOR mode, see the description in the chapter entitled "Changing Options at Run-time". This option is related to the /C option, which this option has priority over. (C) Copyright 1984-85 Hersey Micro Consulting 37 (C) Copyright 1984-85 Hersey Micro Consulting 37 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation O - One Finger Typing _ ___ ______ ______ O - One Finger Typing The option is the letter O This option gives the starting value for the FANSI-HANDICAP shift mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-CONSOLE _____________ FANSI-RM commands. Using /O=1 means FANSI-CONSOLE sets FANSI- FANSI-CONSOLE _____________ HANDICAP at the start. Using /O=0 means FANSI-CONSOLE resets FANSI- FANSI-CONSOLE _____________ HANDICAP at the start. FANSI-CONSOLE ignores other values. This option specifies whether to allow one finger typing. Using /O=1 FANSI-CONSOLE _____________ means FANSI-CONSOLE toggles the Alt, Ctrl, or shift key states only when you press the appropriate keys, and not when you release them. This means that you remain Alt'ed, Ctrl'ed, or shifted until you press the same key again. Note that in this situation, each shift key is a separate shift lock and both must be off to get unshifted FANSI-CONSOLE _____________ characters. Using /O=0 means FANSI-CONSOLE toggles the Alt, Ctrl, or shift key state both when you press the appropriate key, and when you release it. The default value is /O=0, since this gives the normal behavior of keyboards. The /O option is for handicappers and others who find it impractical to press multiple keys at once, such as both the control key and an not alphabetic key. If you are not physically handicapped, you will probably want to use /O=0. This option has nothing to do with whether you are a touch typist versus whether you hunt and peck. P - Page Overlap _ ____ _______ P - Page Overlap This option specifies the starting value of the number of lines of overlap between pages used by the scroll recall feature. Using /P=0 also implies that no status line should be shown on the recall screen, so that the whole screen may be seen. Using /P with a value which is more than zero also implies that a status line should be shown at the top of the recall screen. The default value is /P=4. This determines the starting value for FANSI-OVERLAP. It may be changed later using the FANSI-SOV escape sequence, or the DarkPlus and DarkMinus keys in the scroll recall mode. For more information about the scroll recall feature, see the section entitled "How do I recall lines which have scrolled away?" in the chapter entitled "Advanced Features". Related options are /L, and /R. (C) Copyright 1984-85 Hersey Micro Consulting 38 (C) Copyright 1984-85 Hersey Micro Consulting 38 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation R - Recall Line Maximum _ ______ ____ _______ R - Recall Line Maximum This option specifies how many lines of space to reserve for the FANSI-CONSOLE _____________ scroll recall feature buffer. Using /R=0 means that FANSI-CONSOLE should reserve no space for the scroll recall feature, which means that scroll recall is completely unusable. Using a non-zero value FANSI-CONSOLE _____________ for /R implies that FANSI-CONSOLE initially turns the scroll recall feature on. Using a non-zero value for /R which is less than 50 FANSI-CONSOLE _____________ implies that FANSI-CONSOLE reserves 50 for scroll recall, since there must be enough room in the buffer for at least one screenful, and screens may be as much as 50 lines high. A value for /R which is at FANSI-CONSOLE _____________ least 50 lines indicates that FANSI-CONSOLE reserves exactly that many lines of memory for scroll recall. Each line requires 160 bytes of memory. For example, /R=100 requires about 16 KB more read/write memory than /R=0. The default value is /R=0, since this gives the minimum space usage. For more information about the scroll recall feature, see the section entitled "How do I recall lines which have scrolled away?" in the chapter entitled "Advanced Features". Related options are /L, and /P. S - Screen Save Timeout _ ______ ____ _______ S - Screen Save Timeout FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use its screen saver feature and how long the timeout should be. The value used is the number of 1/18.2 second intervals counted before turning off the display. If you do not press any keys and the current program does no screen writing using ROM BIOS calls or MS(PC)-DOS before the FANSI-CONSOLE _____________ timeout, FANSI-CONSOLE automatically turns off the console screen display. This prevents you from accidentally permanently burning a pattern into your display screen by displaying the same thing on the FANSI-CONSOLE _____________ screen too long. When FANSI-CONSOLE turns off the display, any key including a shifting key may be pressed to turn the display back on. FANSI-CONSOLE _____________ When FANSI-CONSOLE turns the display back on, the data displayed FANSI-CONSOLE _____________ appears the same as it did just before FANSI-CONSOLE turned off the display. The default count of /S=0 may be used to specify always keeping the screen display on, which is the behavior of the standard IBM-PC console software. We do not recommend this setting, but we make the defaults as compatible as possible with the standard, to avoid surprising people. Otherwise the timeout can be as much as about one hour if you use /S=0FFFF. We suggest /S=10000, for a timeout of about ten minutes. 18.2 units/sec * 60 secs/min * 10 min = 10920 units, actually. This is the starting value for FANSI-SCRN. It may be changed later using the FANSI-SOV escape sequence. (C) Copyright 1984-85 Hersey Micro Consulting 39 (C) Copyright 1984-85 Hersey Micro Consulting 39 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Note that some programs set the border, color palette, or screen display mode directly instead of through the BIOS calls. Such programs include some painting programs, like PC Paint, and some programs which use more than one screen display mode to option between graphics and text, like Lotus 123. When you use these FANSI-CONSOLE _____________ programs and FANSI-CONSOLE turns off the screen and then turns it on again, the border or palette may be a different color than before FANSI-CONSOLE _____________ FANSI-CONSOLE turned off the screen, or the screen may appear totally distorted. This is because hardware state of these values cannot be read and then restored, but they must be changed to turn off the FANSI-CONSOLE _____________ screen. So to do the restore, FANSI-CONSOLE must assume the values FANSI-CONSOLE _____________ were as they were last set by FANSI-CONSOLE. You must use /B=0 for color graphics adapters which do not blink when used with the normal IBM-PC software, unless you must also use a /X option with your computer. Otherwise the screen save feature does not work properly. If you specify the /S option and /B=0, but the screen does not turn off after the specified period, then possibly your display adapter has no way to turn off the video signal. There is no way to have the /S option work with such adapters. It may also be that the way the video signal enable is turned off is different FANSI-CONSOLE _____________ from that required by IBM standard adapters. FANSI-CONSOLE may have an extended features option which must be used with such an adapter. See the description of the /X options below. If you specify the /S option and it works, but only sometimes, then you are probably running a program which replaces the timer interrupt vector instead of chaining to it. If a program does this, then FANSI-CONSOLE _____________ ____ ____ _______ FANSI-CONSOLE is only able to turn off your display when that program __ ___ _______ is not running. If the same program also does not restore the timer FANSI-CONSOLE _____________ interrupt vector, then FANSI-CONSOLE is also not able to turn off _____ ____ _______ __ ____ your display after that program is done. If a program does this, it FANSI-CONSOLE _____________ is a problem with that program, and not with FANSI-CONSOLE, but please tell us about the program. _____ If the screen save feature never works when you are running a particular application program, something on a status line is probably constantly being refreshed. This never allows the screen save time to timeout. It would be more appropriate for the program to refresh the status line only when a change would be made. Related options are /B, and /X. (C) Copyright 1984-85 Hersey Micro Consulting 40 (C) Copyright 1984-85 Hersey Micro Consulting 40 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation T - TTY ROM BIOS Calls Use ANSI X3.64 _ ___ ___ ____ _____ ___ ____ _____ T - TTY ROM BIOS Calls Use ANSI X3.64 This option specifies whether the ROM BIOS video call for TTY output (INT 10 hex with AH = 15 decimal) should process ANSI X3.64 standard FANSI-CONSOLE _____________ escape sequences. Using /T=1 means FANSI-CONSOLE processes the ANSI X3.64 standard escape sequences found in the TTY output calls. Using FANSI-CONSOLE _____________ /T=0 means FANSI-CONSOLE processes the TTY output calls in a way compatible with the standard IBM-PC console software. The default value is /T=0. We generally recommend /T=0, for compatibility. With /T=1, some communications programs may be made to process ANSI X3.64 escape sequences properly, and emulate an ANSI X3.64 standard terminal, even when those programs do not normally have that as a feature. Specifying /T=1 is only incompatible with a few programs which use the TTY call to display IBM-PC characters with values less than the value of a space. For more information about the FANSI-TTY mode, see the description in the chapter entitled "Changing Options at Run-time". V - Vertical Retrace Delay _ ________ _______ _____ V - Vertical Retrace Delay FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should wait for the vertical retrace signal to go on before blinking the video display when scrolling the color display in the 25x80 alphanumeric screen display mode. It has no effect for monochrome display adapters. It FANSI-CONSOLE _____________ has no effect if /B=0. Using /V=1 means FANSI-CONSOLE should wait. FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ Using /V=0 means FANSI-CONSOLE should not wait. FANSI-CONSOLE ignores other values. If /B=1 must be used, /V=1 is recommended because it makes the blink slightly less annoying. The drawback to waiting with /V=1 is that it slows the scrolling speed slightly. However, this is what the standard IBM-PC console software does, so it appears "normal". The default value is /V=1, because /B=1 is also the default. For the IBM-PC color graphics adapter, we recommend /V=1. Related options are /B, /H, and /W. (C) Copyright 1984-85 Hersey Micro Consulting 41 (C) Copyright 1984-85 Hersey Micro Consulting 41 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation W - Word Wide Screen Move _ ____ ____ ______ ____ W - Word Wide Screen Move FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should move a whole word at a time after waiting for horizontal retrace. It has no effect for monochrome display adapters. It has no effect if /H=0. Using /W=1 FANSI-CONSOLE _____________ means FANSI-CONSOLE should move a word at a time. Using /W=0 means FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE should move a byte at a time. FANSI-CONSOLE ignores other values. If it does not cause "snow" on the screen, /W=1 is recommended because it makes the scrolling faster. This snow is also known as hashing. However, /W=0 is the default because /W=1 causes hashing on the IBM-PC graphics adapter on an IBM-PC. Generally, only machines with a 16-bit wide data bus and an 8086, 80186, or 80286 like the IBM-PC AT, the AT&T PC, or DeskPro are fast enough for /W=1 to not cause snow. The chapter entitled "Compatibility and Limitations" indicates those machines for which /W=1 is appropriate. In addition we have a test program called SNOW. Just run SNOW, and you will able to see which way to set the /W option. Specifying a /X value may effect the default setting of /W. Related options are /B, /H, and /V. (C) Copyright 1984-85 Hersey Micro Consulting 42 (C) Copyright 1984-85 Hersey Micro Consulting 42 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation X - Extensions _ __________ X - Extensions FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use extensions which are peculiar to a particular display adapter. You do not need to understand the reasons, just that if you have the hardware which requires the extensions, that you must set the /X option accordingly. /X=0 means use no extensions, and is therefore the default. /X=1 means use Zenith Z150/160 extensions. If you do not use /X=1 for a Zenith Z150/160, then using the /S option with a non-zero value does not turn off the screen display. Also changes defaults to /H=0. /X=2 means use Mad-1 extensions. If you do not use /X=2 FANSI-CONSOLE _____________ for a Mad-1, then FANSI-CONSOLE ignores the break key and the numeric pad comma key. /X=3 means use AT&T 6300 extensions. If you do not use FANSI-CONSOLE _____________ /X=3 for an AT&T 6300, the FANSI-CONSOLE does not light the keyboard status lights. Because of a pair FANSI-CONSOLE _____________ of bugs in the AT&T 6300 BIOS ROMs, FANSI-CONSOLE also hangs the machine without this option. Also changes defaults to /B=0/W=1. /X=4 means use Tandy 1000 extensions. If you do not use /X=4 for a Tandy 1000, then keys which are on and near the numeric keypad do not always generate the values indicated key top labels. Also changes defaults to /H=0. /X=5 means use Data General One extensions. If you do not use /X=5 for a Data General One, then shifted arrow keys do not generate the expected values. Also changes defaults to /H=0. FANSI-CONSOLE _____________ FANSI-CONSOLE ignores other values. Other /X values may be added when we discover that the extensions for one display adapter or computer are incompatible with other display adapters or computers. Check the FCONSOLE.HST file for any recently added values. Related options are /B, /H, and /W. (C) Copyright 1984-85 Hersey Micro Consulting 43 (C) Copyright 1984-85 Hersey Micro Consulting 43 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Y - Yuck, You Should Be So Compatible _ _____ ___ ______ __ __ __________ Y - Yuck, You Should Be So Compatible This option gives the starting value for the FANSI-CMP mode, which may later be changed with the ANSI X3.64 FANSI-SM and FANSI-RM FANSI-CONSOLE _____________ commands. Using /Y=1 means FANSI-CONSOLE sets FANSI-CMP at the FANSI-CONSOLE _____________ start. Using /Y=0 means FANSI-CONSOLE resets FANSI-CMP at the FANSI-CONSOLE _____________ start. FANSI-CONSOLE ignores other values. This option specifies FANSI-CONSOLE _____________ whether FANSI-CONSOLE should be as compatible as it can be to the FANSI-CONSOLE _____________ standard IBM-PC console software. In designing FANSI-CONSOLE, there were a few tough decisions which had to be made. Certain programs directly modify ROM BIOS screen variables themselves before making calls to ROM BIOS screen routines to make other changes. This is not a proper way of doing things, because it violates the intended purpose of the ROM BIOS, but some programs did it anyway. The practice is sometimes called "making endruns around the BIOS". The proper way is to make calls to the appropriate ROM BIOS screen routines to make all the changes. FANSI-CONSOLE _____________ The problem is that, if FANSI-CONSOLE is to be fast and to have several of the new features, it has to use its own internal variables FANSI-CONSOLE _____________ and not the ROM BIOS screen variables. However, if FANSI-CONSOLE does not look at the ROM BIOS screen variables, these programs do not run correctly. When these programs run, it looks like most of the characters are overwritten, in the wrong place, and the screen is mostly empty. So the choice is to be fast, or to be compatible. Since you may have already purchased some of these improper programs, we feel that we should leave the decision up to you, so we have the /Y option as a way for you to make this decision. FANSI-CONSOLE _____________ Using /Y=1 means that FANSI-CONSOLE should start out being more not ___ compatible but slightly slower. This does not mean totally compatible (nothing ever could be), but it is as close as we have figured out how to be and still be fast. This also means that some of the extended features are unusable. Particularly, it means that only 8 screen pages may be used, and that the extended 50 line interlaced screen display modes may not be used. Currently, the speed penalty is about 7% at most, so you may not even notice the difference. The penalty may become greater in later versions if we discover more things that may be done to increase compatibility. FANSI-CONSOLE _____________ Using /Y=0 means that FANSI-CONSOLE should start out being faster but slightly incompatible. It also allows some extended features to be used. This gives enough compatibility to run most but not all programs. Using this mode is a way to test the portability of a program. If it does not run correctly in this mode, it may have problems running on some "almost but not quite" IBM-PC equivalent machines. Of course, it does not mean that a program is portable just because it runs in this mode. (C) Copyright 1984-85 Hersey Micro Consulting 44 (C) Copyright 1984-85 Hersey Micro Consulting 44 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation The default is /Y=1, since this gives normal behavior for as many of your applications as possible. Where it is known that /Y=1 is required for a specific program, it is noted in the compatibility lists. Generally, we recommend using /Y=1. For more information about the FANSI-CMP mode, see the description in the chapter entitled "Changing Options at Run-time". (C) Copyright 1984-85 Hersey Micro Consulting 45 (C) Copyright 1984-85 Hersey Micro Consulting 45 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation FANSI-CONSOLE _________________________________________________ 3.3 "How much memory does FANSI-CONSOLE require?" FANSI-CONSOLE _____________ FANSI-CONSOLE memory requirements vary depending on the options that you have selected and the machine type that you run it on. However, it is possible to estimate the requirements, in case you find you need to cut the fat because of lack memory. FANSI-CONSOLE _____________ The starting point for calculating the resident size of FANSI-CONSOLE is the size of the file FCONSOLE.DEV. This is currently about 32 KB. Currently, there is approximately 4 KB of initialization code in FANSI-CONSOLE _____________ FANSI-CONSOLE which never remains resident. In addition, there is another 4 KB of code for the EGA which will only remain resident if you have an EGA installed. Both or one of these amounts should be subtracted from the file size, depending on whether or not you have an EGA installed. To this reduced file size, you must add the amount of memory reserved for macro strings and parameters. This is given by the /M option or its default. You must also add the number of bytes reserved for scroll recall. This is calculated from the /R option or its default, as described earlier in this chapter. FANSI-CONSOLE _____________ Later versions of FANSI-CONSOLE will probably allow some specific portions of this resident size to be placed into expanded AT type memory or Lotus/Intel extended type memory. (C) Copyright 1984-85 Hersey Micro Consulting 46 (C) Copyright 1984-85 Hersey Micro Consulting 46 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background Chapter 4 Chapter 4 Programming Background Programming Background ________________________________________ 4.1 Which screen writing method is best? This chapter is devoted to a discussion of screen and keyboard usage methods and their portability to other computers. It is an introduction for the next two chapters, to help you decide which type of screen writing method to use in your programs. You do not need to read it unless you are going to write programs for your computer. You might want to read it anyway, if you are curious, since it is not too technical. There are three general ways to use the screen and keyboard: 1. Direct hardware manipulation. 2. ROM BIOS calls. 3. MS(PC)-DOS calls. Each has its own advantages and disadvantages. As you move down our list above, the methods generally become somewhat slower and less versatile but they also become more computer independent. It is probably obvious why you would want your programs to write to the screen as fast as possible. What may not be obvious is why you might want them to be computer independent. (C) Copyright 1984-85 Hersey Micro Consulting 47 (C) Copyright 1984-85 Hersey Micro Consulting 47 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background The more computer independent a program is, the more likely it will be that that program will run on your particular computer. Sure, you bought your IBM-PC or equivalent because it is (or is equivalent to) what everyone else is buying. We are sure you have heard stories from friends about how great some IBM-PC adapter was but it was not "IBM-PC compatible". By the way, we like the word "equivalent" better than "compatible", when used in this context. We are also sure that you have at one time or another heard other stories about how badly designed parts of the IBM-PC are. Not that we agree with all such complaints. The problem is that it is impossible to improve on IBM's ideas if everything has to be the same as IBM's! So pick one, please. Which will it be: "equivalent" or "better than IBM's"? Well, if more programs used more computer independent methods to use the hardware on your IBM-PC, you could have your cake and eat it too. For example, consider that many programs use the first screen writing method: direct hardware manipulation. If someone (even IBM) designed a hot new video board for the IBM-PC that allowed you to display 80 lines of 132 columns of text, none of these programs would work with this board. In fact, there are some boards out there that can do something like this. So you paid a high price for all the speed of direct screen writing: you must buy an equivalent board. If the same programs instead called the ROM BIOS or the DOS to do screen writing, all that would be needed is for the screen board manufacturer to provide a replacement for part of the ROM BIOS or part of MS(PC)-DOS for screen writing. A good example of the problems faced is the number of programs which now need to be modified to support the new IBM Enhanced Graphics Adapter (EGA). If these programs had been written differently in the first place, they would not now need to be modified, since IBM included a new ROM BIOS on the EGA itself. It turns out that the IBM-PC ROM BIOS is slow. Since MS(PC)-DOS calls also call the IBM-PC ROM BIOS, they are also slow. Anyway, the price for computer independence is much higher than it needs to be. FANSI-CONSOLE _____________ How do we know? That's what FANSI-CONSOLE is all about! It replaces the standard IBM-PC ROM BIOS software for the screen and keyboard with our own BIOS software. The result is that programs which use the BIOS or MS(PC)-DOS calls for screen writing are speeded up. It also did not help that most of the things that could be done directly to the screen are not supported with some type of MS(PC)-DOS call. This was remedied somewhat with the introduction of the concept of an MS(PC)-DOS device driver. (C) Copyright 1984-85 Hersey Micro Consulting 48 (C) Copyright 1984-85 Hersey Micro Consulting 48 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background There are several reasons that MS(PC)-DOS calls should be used instead of ROM BIOS calls, wherever feasible: 1. The MS(PC)-DOS calls provide some functions in a more convenient manner for the programmer than the BIOS does. In particular, they are the easiest to use from most languages other than assembly language. 2. Program screen displays may be redirected into an MS(PC)-DOS file instead of directed to the screen. From there it can be manipulated just like any other data file. 3. The program may be used with the CTTY program on an external terminal via your serial port. 4. Even more computers using MS(PC)-DOS support the ANSI X3.64 standard through MS(PC)-DOS calls than those supporting an equivalent to the IBM-PC ROM BIOS. The interrupt vectors used by the IBM-PC ROM BIOS standard violate Intel's reservation of them for its newer processors like the 80186. So not all computers which could otherwise be equivalent have the possibility of using these vectors for screen writing or keyboard reading. So the program could be run on more machines now, and in the future. Remember though, that the price we pay for portability is some speed and some versatility. But the price does not have to be unbearable, FANSI-CONSOLE _____________ if you use FANSI-CONSOLE. (C) Copyright 1984-85 Hersey Micro Consulting 49 (C) Copyright 1984-85 Hersey Micro Consulting 49 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Chapter 9 Chapter 9 Compatibility and Limitations Compatibility and Limitations FANSI-CONSOLE ____________________________________________________ 9.1 What do I do if FANSI-CONSOLE gives me problems? FANSI-CONSOLE _____________ If you think that FANSI-CONSOLE is causing a problem, there are ______ several things that you should do before calling us. These are things which help pin down the problem, and reduce the time spent on the phone with us. First of all, remember to do all your testing on the same computer that you had problems with, and that it has been configured the same way as when you had the problems. 9.1.1 Check for the problem in the index under "problem" We have an extensive index at the end of this manual. It is there to help you if you have problems finding what you want to know. Please use it, especially if you do not read the manual from cover to cover. For example, solutions to many common problems can be found by looking up the keyword "problem" in the index. If you can not find something where you looked first in the index, let us know! We think the index should be comprehensive. That minimizes the number of calls we get asking about things which are fully explained in the manual but hard to find. 9.1.2 Check the compatibility lists Check the compatibility lists for an indication that we already know the problem which you are having. We may have already examined the circumstances and decided that nothing can be done about it without major changes. Or we may have indicated that something can be done about it and we are working on it already. At any rate, if you can find the problem mentioned in the compatibility lists the best we can recommend for now is: "Don't do that!". (C) Copyright 1984-85 Hersey Micro Consulting 178 (C) Copyright 1984-85 Hersey Micro Consulting 178 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ 9.1.3 Check for problems without FANSI-CONSOLE FANSI-CONSOLE _____________ Many of the problems reported with FANSI-CONSOLE are not problems FANSI-CONSOLE _____________ with FANSI-CONSOLE at all! Many people assume that if they are having problems at all, it must be that new fangled thing they just installed. However, a simple test can sometimes tell you that it is FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ not FANSI-CONSOLE at all. Simply uninstall FANSI-CONSOLE using the directions given in the chapter entitled "Starting Quickly". Then run the same programs you had problems with before. If they still FANSI-CONSOLE FANSI- _____________ ______ have problems, then it can not be with FANSI-CONSOLE because FANSI- CONSOLE _______ CONSOLE is not installed! If you do not still have problems when you FANSI-CONSOLE _____________ uninstall FANSI-CONSOLE, you are not done yet. 9.1.4 Check for lack of memory problems FANSI-CONSOLE _____________ Many of the problems reported with FANSI-CONSOLE are simply problems caused by not leaving memory for the application programs. If you FANSI-CONSOLE _____________ have a problem with an application program when FANSI-CONSOLE is FANSI-CONSOLE _____________ installed and you think it was caused by FANSI-CONSOLE, one way to check whether it is a memory problem is to run the application program under the MS(PC)-DOS DEBUG program, which happens to be FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ almost as big as FANSI-CONSOLE. Do this when FANSI-CONSOLE is still uninstalled after the last test. Thus, about the same amount of memory is left for the application program. Just "DEBUG program.ext" and "G" to get it running, and "Q" from DEBUG when the application FANSI-CONSOLE _____________ program is done. If it does the same thing as when FANSI-CONSOLE is installed, it is a "not enough memory" problem. This means you have not left enough room for your applications. See the subsection entitled "Leave enough memory for applications programs" in the chapter entitled "Starting Quickly". 9.1.5 Check for interaction problems FANSI-CONSOLE _____________ Many of the problems reported with FANSI-CONSOLE are interactions between several products. The best way to check for an interaction FANSI-CONSOLE _____________ with FANSI-CONSOLE and other products is to start by renaming your AUTOEXEC.BAT file to something else like AUTOEXEC.OLD, and your FANSI-CONSOLE _____________ CONFIG.SYS to something like CONFIG.OLD. Then install FANSI-CONSOLE by itself, with no other resident programs begin loaded from CONFIG.SYS or AUTOEXEC.BAT. Check to see if the problem still appears with your application program. If it does, then it is fairly FANSI-CONSOLE _____________ clear that FANSI-CONSOLE and your application program are not getting along well, and you should report this to us at Hersey Micro Consulting, Inc. This assumes, of course, that the problem is not already mentioned in this manual! Telling us what we already know does not help us fix it faster. (C) Copyright 1984-85 Hersey Micro Consulting 179 (C) Copyright 1984-85 Hersey Micro Consulting 179 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations If the problem does not appear, then you may have some kind of FANSI-CONSOLE _____________ interaction problem with FANSI-CONSOLE and something being loaded in CONFIG.SYS or AUTOEXEC.BAT. The next step is to find out what programs are interacting. This is done by adding the old lines to the back new CONFIG.SYS and then to the new AUTOEXEC.BAT from the old versions, one line at a time. Then, after each line is added, do an Alt-Ctrl-Del and test for the problem once again. When the problem reappears, the last line added to CONFIG.SYS or AUTOEXEC.BAT indicates the most likely culprit. To double check, remove FANSI- ______ everything else but that last line and the DEVICE= line for FANSI- CONSOLE _______ CONSOLE from CONFIG.SYS and AUTOEXEC.BAT and test for the problem again. If the problem appears again, then you know which program FANSI-CONSOLE _____________ FANSI-CONSOLE is interacting with, and you should report this to us at Hersey Micro Consulting, Inc. If the problem fails to reappear at this point, you probably have a complicated interaction problem. At the very least, you should try to remove as many resident programs as possible from the CONFIG.SYS and AUTOEXEC.BAT while still being able to reproduce the problem. This eliminates at least some of the programs you are using from the list of possible causes. 9.1.6 When all else fails....give us a call When all else fails, give us a call or write us a letter. You might try accessing our bulletin board system to see if your problem and a solution, is described there. We suggest that you use the forms found at the end of this manual to determine what information we may need to find the cause of the problem. To access our bulletin board system, dial (313) 994-3946 from 11PM to 8AM Eastern Time. It supports both 300 and 1200 BPS, No parity, 8 bit bytes, 1 stop bit. After getting a carrier, press return several times, until you get a prompt. From then on, the on-line help should explain how to proceed if you do not already know. (C) Copyright 1984-85 Hersey Micro Consulting 180 (C) Copyright 1984-85 Hersey Micro Consulting 180 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________________________________________ 9.2 What limitations does FANSI-CONSOLE have? FANSI-CONSOLE _____________ FANSI-CONSOLE does have some limitations and we hope to remedy these in the future. FANSI-CONSOLE _____________ FANSI-CONSOLE could easily be made to accept more of the ANSI standard escape sequences. We will try to extend it. FANSI-CONSOLE _____________ FANSI-CONSOLE may not work with some keyboard macro programs. Because the typeahead buffer is bigger, it must be put in a different place. We will try to make it work with most of these programs, and try to eliminate the need for separate keyboard macro programs, by FANSI-CONSOLE _____________ adding functions to FANSI-CONSOLE, or to a companion program. FANSI-CONSOLE _____________ FANSI-CONSOLE may not work with some mouse drivers. However, it is compatible with the most popular mice. FANSI-CONSOLE _____________ FANSI-CONSOLE may not work with newer IBM graphics adapters. We will either make separate versions or have appropriate switches. (C) Copyright 1984-85 Hersey Micro Consulting 181 (C) Copyright 1984-85 Hersey Micro Consulting 181 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE ________________________________________________ 9.3 Are there several versions of FANSI-CONSOLE? FANSI-CONSOLE _____________ FANSI-CONSOLE has at least two different versions for differing kinds of machines. The type of machine which a version is meant to run on is indicated by the first character of the serial number: 0 IBM-PC and very compatibles with very compatible ROM BIOS. This includes the IBM-PC AT. The ROM BIOS must have console variables in the same place as the IBM-PC. 1 Computers with IBM-PC work-alike display adapters and keyboards. No ROM BIOS is expected, and if one exists, it is ignored. (C) Copyright 1984-85 Hersey Micro Consulting 182 (C) Copyright 1984-85 Hersey Micro Consulting 182 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE ____________________________________________________ 9.4 What programs are compatible with FANSI-CONSOLE? Any program which only uses MS(PC)-DOS or ROM BIOS screen and FANSI-CONSOLE _____________ keyboard calls should work with FANSI-CONSOLE, and have faster screen painting. Any compiler or assembler should work. Programs which use standard language calls for reading and writing the console should have faster screen painting. Only programs that manipulate hardware address contents or BIOS variables directly may not run correctly FANSI-CONSOLE _____________ with FANSI-CONSOLE. The indication "(faster)" in the list below means that the program's FANSI-CONSOLE _____________ screen writing is noticeably faster using FANSI-CONSOLE than without using it, or, for compilers, that programs written in the language have faster screen writing. Other programs listed which work at the same speed as they would otherwise are indicated as "(not faster)". Finally, some programs have only been reported as compatible but no indication was made about whether they are faster. Let us know when you find a program which is faster, but it is not listed here as being faster. FANSI- ______ The indication "(/Y=0)" means that the program may be run with FANSI- CONSOLE _______ CONSOLE with either /Y=0 or /Y=1. The indication "(/Y=1)" means that FANSI-CONSOLE _____________ the program must be run with FANSI-CONSOLE in it's most compatible mode. For other programs we do not know whether /Y=0 will work, but /Y=1 does work. FANSI-CONSOLE _____________ The indication "(No VT100)" means that FANSI-CONSOLE does not not add VT100 capabilities to the indicated communications program. This is true for many but not all communications programs. (C) Copyright 1984-85 Hersey Micro Consulting 183 (C) Copyright 1984-85 Hersey Micro Consulting 183 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ This list of programs we believe are compatible with FANSI-CONSOLE is not all inclusive by any means! (Names below are all trademarks of indicated companies) ABC - Consortium Software, UofM APX Core Executive - Application Executive Corporation (faster) AutoCad - Autodesk (/S messes up graphics) BACKSCRL.COM (/R=0) (faster) Benchmark - Metasoft C86 C compiler - Computer Innovations, all versions (faster) CGCLOCK - Chart-Master 6.03 - Decision Resources (faster) Condor - Condor Computer (faster) Crosstalk - Microstuf (No VT100) DataEase - DBase II - Ashton-Tate (/Y=1) (faster, no more typeahead) DBase III - Ashton-Tate (not faster, no more typeahead) DESQ - Quarterdeck DOSEDIT - Gersbach, Jack (/Y=1) DOSVIEW Utilities - Lightning Software Easy Business Systems - Sorcim (faster) EasyWriter I - Sorcim/IBM (faster) EasyWriter II - Sorcim (not faster) Edix - Emerging Technologies (not faster) Final Word - Mark of the Unicorn, MS-DOS version (faster) FRAMDISK ________ FRAMDISK - Hersey Micro Consulting (/Y=0) Framework - Ashton-Tate (not faster) Friday - Ashton-Tate (faster) Graphwriter 4.3 - Graphic Communications Hardrunner - IBM Basic, all versions (faster) (/Y=0) IBM DOS Command Retriever (/Y=1) IBM-PC DOS 2.00 (faster) (/Y=0) IBM-PC DOS 2.10 (faster) (/Y=0) IBM-PC DOS 3.00 (faster) (/Y=0) IBM Personal Editor IUS - Accounting Series - General Ledger (faster) (/Y=0) J-Drive - Tall Tree Systems J-Spool - Tall Tree Systems Kedit - Mansfield Software Kermit - Columbia University (faster) Keyworks - Lattice - C compiler, all versions (/Y=0) Leading Edge Word Processer (LEWP) - Leading Edge Lotus 1-2-3 (not faster) (/S messes up graphics) Norton Utilities 2.0 (faster) (/Y=0) Norton Utilities 3.0 (faster if not direct I/O) (/Y=0) The MBA Accountant - Micro Business Applications (faster) Microsoft Assembler (/Y=0) Microsoft C compiler (faster) (/Y=0) Microsoft Parallel Mouse (/Y=1) Microsoft Multiplan MS-DOS version (faster) (/Y=0) (C) Copyright 1984-85 Hersey Micro Consulting 184 (C) Copyright 1984-85 Hersey Micro Consulting 184 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Microsoft Pascal Compiler (faster) (/Y=0) Microsoft Project Microsoft Word 1.1 (not faster) MiniLedger - Paradigm Consultants (faster) MODEM86 _______ MODEM86 - Hersey Micro Consulting (faster) (/Y=0) (VT100) Modula II - Logitech MORERAM - Mouse Systems - PC Mouse Multimate Word Processor - Multimate International (not faster) Multi-OS - Davong (faster) PC/Cutlisting (faster) PC-Draw - Micrografx, Inc. (faster) PC-FILE - Buttonware (faster) (/Y=0) PC/InterComm - Mark of the Unicorn (no screen save) PC Paint - Mouse Systems (not faster) PC Paintbrush - Zsoft Corp PC-TALK - Headlands Press (No VT100) P-Edit - Satellite Software International Polaroid - Palette (/S messes up graphics) PolyForth II - Forth, Inc. (faster) Prokey - RoseSoft (except LAYOUT program) (/Y=0) P.S. Technical Word Processor - Scroll Systems, Inc. (not faster) QMODEM - (VT100) QuadRam - QM2 SAMNA Word - SAMNA Corporation (faster) Sidekick - Borland International (not faster) SmartCom - Hayes (No VT100) SmartKey - Star Accounting - Star Software Systems (faster) SuperCalc 3.2 - Sorcim (not faster) SuperDrive - AST SuperSpool - AST SuperWriter - Sorcim (not faster) Symphony - Lotus Development Corp. (not faster) Teleterm - Tandy (faster) Textra - Ann Arbor Software (not faster) ThinkTank - Living Videotext, Inc. TMS Fastware - Thesys TopView - IBM, preliminary Turbo Pascal - Borland Vedit - CompuView - IBM-PC version (some things faster) Vedit - CompuView - MS-DOS version (faster) Versa Cad 4.0 - (not faster) VidTex - CompuServe Volkswriter - Lifetree Software (not faster) Window - University of Michigan (/Y=0) Word Perfect - Satellite Software International (faster) WordProof - IBM (/Y=0) (faster) Wordstar - MicroPro, IBM-PC version (faster) Wordstar 2000 - MicroPro Zenith - GWBasic (/Y=1) (faster) (C) Copyright 1984-85 Hersey Micro Consulting 185 (C) Copyright 1984-85 Hersey Micro Consulting 185 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________________________________________________ 9.5 What computers are compatible with FANSI-CONSOLE? This list of computers and display adapters we believe are compatible FANSI-CONSOLE _____________ with FANSI-CONSOLE is not all inclusive by any means! (Names below are all trademarks of indicated companies) Amdek - MAI (/H=0) AST - MonoGraphPlus AT&T - 6300 (/X=3 implies /W=1/H=1/B=0) Bronson - Innovation Color Graphics/Printer Adapter Columbia Data Products - Multi Personal Computer Compaq - Compaq (/H=0) - Compaq Plus (/H=0) - Compaq Deskpro (/H=0) Corona - Desktop - (/H=1) - Portable - (/H=1/B=0) Data General - One (/X=5 implies /H=0/B=0, Starting V1.12) (has no video disable) (Some problems with mode changes) Eagle Computer - Color/Graphics Adapter Everex - Evercolor - Graphics Edge Suggest use J1=J3=OFF, and /H=0/B=0, although it causes black snow. FANSI-CONSOLE _____________ J2 irrelevent for FANSI-CONSOLE. - Edge - Graphics Pacer Genoa Spectrum - Hercules - B&W Graphics Card (no support for graphics modes or second page) - Color Card (/H=1) IBM - PC, 64 KB motherboard - PC, 256 KB motherboard - PC/XT - Portable PC - PC/AT (/W=1) - Monochrome Display Adapter (MDA) - Color Graphics Adapter (CGA) (/H=1) - Enhanced Graphics Adapter (EGA) (automatic /H=0) (full support starting with V1.13) Innovation - Product #1007 Leading Edge - Leading Edge PC MA Systems - PC Peacock Mad Computer - Mad-1 (/X=2) MicroGraphics Technology - MasterGraphics I Adapter Mylex - Chairman graphics board Paradise - Modular Graphics Card (/H=0/B=0) (C) Copyright 1984-85 Hersey Micro Consulting 186 (C) Copyright 1984-85 Hersey Micro Consulting 186 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations - Multi Display Card (/H=0/B=0) Persyst - BoB Color Adapter (/S depends on jumpers) - Monochrome Board Plantronics - ColorPlus (/H=1) Profit Systems - Multigraph video card Quadram - QuadSprint (faster) - Quadcolor I & II (/H=0) (Background color remains in screen save) Sigma Designs - Color 400 Color Adapter Sperry - Sperry PC (/H=1) STB - Graphix Plus II Tandy - Tandy 1000 (/X=4 implies /H=0, Starting V1.10) Tandy 1200 Tecmar - Graphics Master (/H=0) Tseng Laboratories - UltraPak Board Zenith - Z150 series (/X=1 implies /H=0) Z160 series (/X=1 implies /H=0) If an adapter has no video disable, then the screen save feature cannot be made to work. (C) Copyright 1984-85 Hersey Micro Consulting 187 (C) Copyright 1984-85 Hersey Micro Consulting 187 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE ______________________________________________________ 9.6 What programs are incompatible with FANSI-CONSOLE? The following are some areas of expected incompatibility problems: 1. Programs which replace the keyboard interrupt vectors may cause FANSI-CONSOLE _____________ some difficulty for FANSI-CONSOLE or vice versa. 2. Programs which try to insert characters into the keyboard FANSI-CONSOLE _____________ typeahead buffer may not work with FANSI-CONSOLE. 3. Some programs that manipulate BIOS variables directly. 4. MS(PC)-DOS versions earlier than MS(PC)-DOS 2.00 do not have a standard mechanism for installing loadable device drivers. It is conceivable that if there is enough demand, a version may be made for earlier versions of MS(PC)-DOS. However, in general other application packages should instead be upgraded to work with the current version of MS(PC)-DOS (even if not to use new MS(PC)-DOS features). In most cases other application products need no upgrading to work under the current MS(PC)-DOS version. In other cases the upgrade should be available for a small price. 5. Some programs that run from an AUTOEXEC.BAT file and which cause the MS(PC)-DOS to redo part of the bootstrap process FANSI-CONSOLE _____________ after FANSI-CONSOLE has been initialized. This is because they FANSI-CONSOLE _____________ are reusing the memory that FANSI-CONSOLE resides in when it is active and processing timer interrupts. Such programs should be made into device drivers and placed first in the CONFIG.SYS file, or be made to use INT 19. 6. Programs which do not work properly with the IBM-PC ANSI.SYS driver. Most of these kinds of programs work for the most part, but some characters used in display messages are ANSI X3.64 control characters and therefore do not get displayed. 7. Programs which expect all MS(PC)-DOS console reading and writing to eventually be done through the ROM BIOS, instead of directly by the MS(PC)-DOS console driver. (C) Copyright 1984-85 Hersey Micro Consulting 188 (C) Copyright 1984-85 Hersey Micro Consulting 188 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Please tell us about these programs so we may either find a solution for you and others in the same predicament or at least give a more specific warning. Since we may be able to solve the problem, programs may move from this list to the one above. Sometimes we leave them in this list, but give a patch which makes specific FANSI-CONSOLE _____________ versions of the programs below work with FANSI-CONSOLE. (C) Copyright 1984-85 Hersey Micro Consulting 189 (C) Copyright 1984-85 Hersey Micro Consulting 189 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ This list of programs we believe are incompatible with FANSI-CONSOLE is not all inclusive by any means! FANSI-CONSOLE _____________ Programs we believe are NOT compatible with FANSI-CONSOLE: (Names below are all trademarks of indicated companies) DDATE - Works but arrow characters displayed are ANSI control characters. DeskMate - Tandy First typed char doesn't display until second char is typed. DiskCat - Nelson Ford Crashes. Double Dos - SoftLogic Solutions Expects MS(PC)-DOS console writing to all go through the ROM BIOS. DR-Draw - Digital Research Crashes immediately. Easy-DOS-It Ellar - Ramdisk Soft reboot program does not load. IBM-PC DOS 1.0 - Does not allow loadable device drivers. IBM-PC DOS 1.1 - Does not allow loadable device drivers. KeyNote - KEYBFR, KEYBGR, KEYBIT, KEYBSP, KEYBUK - IBM PC DOS FANSI-CONSOLE _____________ Replaces FANSI-CONSOLE keyboard vectors causing extra functions to be unavailable. Memory/Shift - North American Business Systems, Inc. Expects MS(PC)-DOS console writing to all go through the ROM BIOS. Microsoft - Serial Mouse & MS-WORD Cursor does not appear. MultiLink - Software Link Expects MS(PC)-DOS console writing to all go through the ROM BIOS. Prokey - RoseSoft Everything but Prokey LAYOUT program works. LAYOUT requires ROM based BIOS keyboard handlers. RESET.COM - Apparat REMIND - Causes "missed characters". Savvy PC - Excalibur Technologies Corp. Immediate crash when run. SCRLLOCK - Equivalent function already in FANSI-CONSOLE _____________ FANSI-CONSOLE. SCRNSAVE - Equivalent function already in FANSI-CONSOLE _____________ FANSI-CONSOLE. (C) Copyright 1984-85 Hersey Micro Consulting 190 (C) Copyright 1984-85 Hersey Micro Consulting 190 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Seasoned Systems - Dvorak keyboard program. Equivalent function already in FANSI-CONSOLE _____________ FANSI-CONSOLE. SpeedKey - Public Domain Equivalent function already in FANSI-CONSOLE _____________ FANSI-CONSOLE. Superkey - Borland First typed char doesn't display until second char is typed. Visage Laser Disk - Crashes immediately. Xywrite - Reported that it only works when BREAK=OFF. Not well investigated yet. (C) Copyright 1984-85 Hersey Micro Consulting 191 (C) Copyright 1984-85 Hersey Micro Consulting 191 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _______________________________________________________ 9.7 What computers are incompatible with FANSI-CONSOLE? For some computers, there are currently some general problems we know which may prevent portability to computers other than IBM-PC's. FANSI-CONSOLE _____________ 1. FANSI-CONSOLE always resides in memory. Although it is not a big program, it may be big enough to cause problems on a small computer (192 KB or less) with at least some other application programs not having enough remaining memory. Also using other memory resident programs, even on larger computers, may cause memory space problems, but these are often solvable. Such memory resident programs include ram-disks and print spoolers. One simple solution for problems related to these programs is to reduce their memory usage a bit. Of course, it is also usually possible to eliminate the problem by buying more memory for your computer. In these cases, just one bank of 64 KB is much more than enough. 2. The location of keyboard ROM BIOS variables must be the same as FANSI-CONSOLE _____________ the IBM-PC's in order for FANSI-CONSOLE to support some of the fancier keyboard macro programs. We will have a version of FANSI-CONSOLE _____________ FANSI-CONSOLE for machines with slightly less compatible ROM BIOSes. 3. The location of the lower half of the font table for the graphics modes depends upon your BIOS ROM. This address is settable using the "/F=" option on the device specification line in CONFIG.SYS. 4. Instructions necessary to prevent the soft restart (Ctrl-Alt-Del) from doing the complete power up self tests differ on different computers. Those necessary on the IBM-PC may be dangerous on other computers. We are investigating possible solutions to this. 5. The computer may not be completely hardware equivalent with the IBM-PC. If the computer's equivalence is only at the ROM BIOS FANSI-CONSOLE FANSI- _____________ ______ level, then FANSI-CONSOLE will not work. For example, FANSI- CONSOLE _______ CONSOLE will definitely not work on any MS(PC)-DOS computer with a terminal which is connected to the computer via a serial port. (C) Copyright 1984-85 Hersey Micro Consulting 192 (C) Copyright 1984-85 Hersey Micro Consulting 192 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations This list of computers and display adapters we believe are FANSI-CONSOLE _____________ incompatible with FANSI-CONSOLE is not all inclusive by any means! Computers and display adapters we believe are NOT completely FANSI-CONSOLE _____________ compatible with FANSI-CONSOLE: (Names below are all trademarks of indicated companies) Control Systems - Artist - 7220 Chip DEC - Rainbow - Not a hardware compatible machine. The machine does have enough similarities that it may be worthwhile for us to FANSI-CONSOLE _____________ make a version of FANSI-CONSOLE for it. It would turn it into a more compatible machine. Eagle - Reported to work but there are extra unsupported keys. We do not have enough documentation about them yet. Epson QX-10 w/Titan PC emulater- Might work, but doubtful. We do not have enough documentation about them yet. Everex - The Ace - 7220 Chip Frontier Technologies - Business Graphics Board 7220 Chip - Intelligent High Resolution Graphics 7220 Chip IBM - PC jr. - We have not tested it yet. We suspect however that the FANSI-CONSOLE _____________ size of FANSI-CONSOLE and the fact that it is always resident will preclude its use on this computer with most applications, because of memory size limitations. There may also be keyboard problems. However, we may create a version for this computer. IBM - Professional Graphics Adapter - We have done some testing and it appears to work in several modes, but we have not tested it enough to know that there are no problems. IBM - 3270 PC - Not hardware equivalent to standard PC video adapters. IDEAssociates - IDEAgraph Color Graphics Card - 7220 Chip Matrivision - Matrigraph - 7220 Chip (C) Copyright 1984-85 Hersey Micro Consulting 193 (C) Copyright 1984-85 Hersey Micro Consulting 193 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations NEC APC II- Same problem as DEC Rainbow. Number None - Revolution Graphics Board - 82720 Chip Paradise - Modular Graphics (with monochrome monitor) MGC.COM crashes. Quadram - DataView Keyboard does not have hardware debouncing. Keys come out duplicated. Sigma Designs - Graphics Dazzler I & II - 7220 Chip Tava - PC - Works for the most part, but on the machine we tried, Ctrl-Alt-Del puts the computer in an infinite loop. Solution seems possible. Tandy 2000 - Same problem as DEC Rainbow. Texas Instruments - Professional Computer - Same problem as DEC Rainbow. Wang PC w/o/PC video card - Same problem as DEC Rainbow. Wang PC w/PC video card - Might work, but doubtful. We do not have enough documentation about them yet. Zenith Z100 - Same problem as DEC Rainbow. (C) Copyright 1984-85 Hersey Micro Consulting 194 (C) Copyright 1984-85 Hersey Micro Consulting 194 FANSI-CONSOLE Credits _____________ FANSI-CONSOLE Credits Chapter 10 Chapter 10 Credits Credits _________________________ 10.1 How did you do that? We know you have questions about our company and how our products are produced. Needless to say, we use only the finest unnatural ingredients. Hersey Micro Consulting, Inc. is a small new company formed in 1984 from a four year old consulting business owned by Mark Hersey. We are specialists in system software for microcomputers. Our company is dedicated to promoting software portability among machines. FANSI-CONSOLE _____________ FANSI-CONSOLE was conceived as a notion that there must be a way to make the IBM-PC color graphics display adapter to scroll large portions of the screen quickly without blinking. Although some programming was done in that direction as early as January, 1983, the FANSI-CONSOLE _____________ programming of FANSI-CONSOLE as a product by itself began in earnest in November, 1983. It was introduced to the public in October, 1984. FANSI-CONSOLE _____________ The FANSI-CONSOLE source program is about 30000 lines of code written in Microsoft's Macro Assembler. For some reason, it keeps getting bigger, too. Unlike many folks, we like that assembler, including its primitive type checking. In fact, we wish it had more type checking. We use a set of macros for structured programming that give us nested IF-THEN-ELSE type statements and LOOP type statements. Some utility programs were written in C and compiled with a Lattice C or Microsoft C compiler (we like the generated code) or a Computer Innovations C compiler (we like the library source). (C) Copyright 1984-85 Hersey Micro Consulting 195 (C) Copyright 1984-85 Hersey Micro Consulting 195 FANSI-CONSOLE Credits _____________ FANSI-CONSOLE Credits Draft copies of complete printed user manual including the on-disk abbreviated user manual are processed by the Mark of the Unicorn's FinalWord word processor. Spelling is periodically checked by IBM's WordProof. Final copies are generated by passing the FinalWord source files through a conversion program called FW2TXF, running under MS-DOS, written by Pat Sherry at the University of Michigan. Then they are transferred to the Michigan Terminal System (MTS) at the University of Michigan and processed by a program called TEXTFORM written at the University of Alberta. The camera ready copy is then produced on a Xerox 9700 page printer. Programs were compiled and assembled on a Lomas Data Products Lightning 286 S100 bus computer running MS-DOS, which is sometimes downgraded with a Seattle Computer Products 8086 board. Programs were tested first and most frequently on an IBM-PC with a Tecmar Graphics Master display adapter board and a Princeton Graphics color monitor. It also has an AST Six Pack Plus multi-function board, a Mountain hard disk controller, and an Interface Inc. hard disk system. Naturally, we use IBM-PC DOS on this machine. Programs are also frequently tested on a Zenith Z150, with a Seattle Computer RAM+6 board and Interface Inc. hard disk system. Naturally, we use Z-DOS on this machine. We thank these companies for their creative efforts and for putting their useful products in the marketplace. We also thank our beta-testers for putting up with unstable versions and providing useful comments. (C) Copyright 1984-85 Hersey Micro Consulting 196 (C) Copyright 1984-85 Hersey Micro Consulting 196 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing Chapter 11 Chapter 11 Distribution and Licensing Distribution and Licensing FANSI-CONSOLE ____________________________________________ 11.1 You mean FANSI-CONSOLE is not freeware? FANSI-CONSOLE (tm) _____________ ____ The program FANSI-CONSOLE (tm) is a commercial product and is not public domain. It is not "freeware" either, although its distribution is similar to that of "freeware". NOT ___ We prefer NOT to call it "freeware" for three reasons: 1. The name "freeware" implies something for nothing, and we still believe that we are entitled to be paid by you for using our software, if you like it enough to use it. abbreviated ___________ 2. Only the abbreviated user manual is on the distribution diskettes. Several chapters describing advanced features in complete ________ detail have been removed from the complete user manual to create the abbreviated user manual. The complete user manual is not free and must be purchased if one is desired. 3. "Freeware" is also a trademark of The Headlands Press, Inc. and not of our own. If it were not trademarked and were merely a generic classification, we would have less complaint about that aspect of things. Instead, perhaps we should call it "fairware". We want things to be fair for you and for us. (C) Copyright 1984-85 Hersey Micro Consulting 197 (C) Copyright 1984-85 Hersey Micro Consulting 197 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE _____________ The basic difference between the license for FANSI-CONSOLE and that FANSI-CONSOLE _____________ of software which is freeware is that use of FANSI-CONSOLE beyond a _________ _____ _______ free trial period, is subject to a low mandatory usage royalty _______ payment instead of a voluntary usage royalty payment (sometimes called a "contribution" in the latter case). Unlike many commercial software vendors, we feel that you are entitled to a test drive with our software for a free trial period. On the other hand, like many commercial software vendors, we feel that if you continue use our software you should pay us for the privilege. The price you pay should still be fair, but it should not be free. (C) Copyright 1984-85 Hersey Micro Consulting 198 (C) Copyright 1984-85 Hersey Micro Consulting 198 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE __________________________________________________ 11.2 How are you limiting my use of FANSI-CONSOLE? FANSI-CONSOLE (tm) abbreviated _____________ ____ ___________ The program FANSI-CONSOLE (tm) and its abbreviated user manual are copyrighted restricted ___________ __________ copyrighted by Hersey Micro Consulting, Inc. We give restricted permission to make unlimited numbers of copies for personal use. We restricted __________ also give restricted permission to make unlimited numbers of copies of the diskettes for distribution to others. To allow such copying, ___ ____ _________ it is not copy protected. 11.2.1 Limitations The restrictions on this permission to make unlimited numbers copies ___ ____________ __ ____ __________ __ ____ _________ _______ ______ The restrictions on this permission to make unlimited numbers copies are as follows: ___ __ ________ are as follows: _______ ______ __ ___ ____ _______ _______ ___________ __ 1. Printed copies of the user manual, whether abbreviated or _________ ____ ___ __ ___________ complete, must not be distributed without a written license from Hersey Micro Consulting, Inc. to do so, even if it is FANSI- ______ done for free and with no service charge. All copies of FANSI- CONSOLE abbreviated _______ ___________ CONSOLE and its abbreviated user manual which are distributed to others must be on magnetic media, such as diskettes, or via electronic communications such as via electronic bulletin board systems or electronic information networks. The recipients must each print their own copies of the abbreviated user manual. ___ _____ __ ___ ________ ____ ______ ____ ___ ___ __ ___ 2. The parts of the complete user manual that are not in the ___________ ____ ______ ____ ___ __ ___________ abbreviated user manual must not be distributed in any form, especially printed or on magnetic media, without a written license from Hersey Micro Consulting, Inc. (C) Copyright 1984-85 Hersey Micro Consulting 199 (C) Copyright 1984-85 Hersey Micro Consulting 199 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing ___ ______ ___________ __ ______ ____ _______ _____ _________ 3. All copies distributed to others must include files identical __ ___ ___ ________ _____ to all the original files. A list of files is included in this manual. So the program must not be distributed without the abbreviated user manual, for example. The files may be condensed via data compression techniques if the decompression process results in files identical to all the original files, and that the decompression program is included on the media in object form. Versions of the program or abbreviated user manual which have been otherwise modified, or incorporated into other programs in whole or in part, must not be further distributed. Files indicating program patches, or user manual addenda, may be added to the media as separate files, providing that there is room for such files on the media. Such changes must not remove or change the copyright notices found in the program or abbreviated user manual. FANSI-CONSOLE ___ __ _____________ ______ ___ ____ __ _____ ___ __ ___ 4. Use of FANSI-CONSOLE beyond ten days of first use of the ________ ___ _____ _____ ________ __ _______ __ _ _________ program, the "free trial period", is subject to a mandatory _____ _______ _______ __ ___ _______ usage royalty payment of $25 (MI+4%) (United States) per computer console (CRT) on which it may be used simultaneously. This is true unless you have received the published (printed z and bound) form of the complete user manual, the cost of which includes the usage royalty payment for one computer console (CRT). This usage royalty must be delivered directly to Hersey Micro Consulting, Inc. at the address on the cover page of this manual. The free trial period is intended to allow you to try the program before paying for it. If at the end of the free trial period, you decide you do not want to pay the usage royalty, this may be done providing all copies of the program which are or will be in your possession are never used by you again. Even in this case they may be further distributed. Obviously, even though payment is legally mandatory, we are relying on your honesty, because in most cases, we do not have much capability to enforce it. Remember that your payment will help us to afford to develop other fine programs that you may also be interested in using. FANSI-CONSOLE _____________ 5. Serial reuse, or moving FANSI-CONSOLE from one computer console to use it on another, is specifically allowed. We require that FANSI-CONSOLE _____________ either FANSI-CONSOLE is first removed from the original computer console (CRT) before use on the second, or that the original computer console (CRT) be unattended during use on the FANSI-CONSOLE _____________ second. Thus FANSI-CONSOLE is only in active use on one computer console at a time. This is roughly equivalent to the concept of a per user license. (C) Copyright 1984-85 Hersey Micro Consulting 200 (C) Copyright 1984-85 Hersey Micro Consulting 200 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE __________ __ _____________ ______ ___________ __ ______ ____ 6. Recipients of FANSI-CONSOLE copies distributed to others must ___ __ _______ ___ ___ _____ _______ __ __________ not be charged for the usage royalty by unlicensed ____________ distributors. The recipients must be encouraged to follow the terms of this licensing agreement. Recipients should note that this means that payment of such distribution fees does not cover the usage royalty, which must still be paid to Hersey Micro Consulting, Inc., if the program is used beyond the free trial period. Distribution charges (such as materials and postage) may be made if they are no more than $10 per copy and no more than that charged for other media of similar construction, capacity, and quantity from the same distributor. (C) Copyright 1984-85 Hersey Micro Consulting 201 (C) Copyright 1984-85 Hersey Micro Consulting 201 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 11.2.2 Rights Payment of the usage royalty fee entitles you to: 1. A copy of the next program update (does not include printed complete user manual) directly from us. If you describe a feature you would like included, and we feel that we are likely to add some similar feature, we will delay shipment until that similar feature is supported. use FANSI-CONSOLE ___ _____________ 2. A license to use updated versions of FANSI-CONSOLE, if you can not ___ obtain them, for no additional usage royalty fee. It does not include the costs of distributing such updated versions. FANSI-CONSOLE _____________ 3. Request help with solving FANSI-CONSOLE related problems. We do not guarantee that telephone help will be given to unlicensed users. Remember that such things cost a good deal of money to support. We have set up a bulletin board system to provide information about new versions and a mechanism for initiating problem resolution. 4. Assignment of a new serial number. It will be placed in the version heading of any update you receive directly from us. It should be used as an identifying number when requesting updates or help. 5. Feel good about yourself. You have supported the cause of inexpensive software, with minimal usage restrictions. (C) Copyright 1984-85 Hersey Micro Consulting 202 (C) Copyright 1984-85 Hersey Micro Consulting 202 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE ____________________________________________________ 11.3 How do I know if FANSI-CONSOLE is right for me? 11.3.1 DISCLAIMER 11.3.1 DISCLAIMER FANSI-CONSOLE _____________ FANSI-CONSOLE and its user manual are provided "as is". If you do not like it after the free trial period, do not use it. If you do not use it after the free trial period, do not pay for it. We cannot warrant it for all possible purposes, as we know it has limitations. We have even tried to notify you of the limitations we already know about. We cannot warrant it for your specific purposes, because it would cost us much more to determine its suitability for your purposes than we are charging. FANSI-CONSOLE _____________ It is up to you to determine the suitability of using FANSI-CONSOLE with any other program or with any computer. Mention of any other program or a computer in this manual is not a guarantee by Hersey FANSI-CONSOLE _____________ Micro Consulting, Inc. of suitability of using FANSI-CONSOLE with that other program or computer. We do occasionally make mistakes in the user manuals, and they cannot always be rectified by changing the program. In no event will Hersey Micro Consulting, Inc. be liable, either to you or to any other party, for any damages, including loss of profits, lost savings, or other incidental or consequential damages FANSI-CONSOLE _____________ arising out of the use of or inability to use FANSI-CONSOLE, even if we have been advised of the possibility of such damages. Since you may have received this version from someone other than Hersey Micro Consulting, Inc., it may have been mangled on its way to you. We obviously can not warrant that no one has done that. We certainly hope no one will do that, anyway. We reserve the right to make modifications to the program and user manuals without notification to you. (C) Copyright 1984-85 Hersey Micro Consulting 203 (C) Copyright 1984-85 Hersey Micro Consulting 203 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE ____________________________________________________ 11.4 How do I get updated versions of FANSI-CONSOLE? All prices below are subject to change if our costs get out of hand. We will try to hold the price as low as possible, to encourage everyone FANSI-CONSOLE ________ _____________ everyone to use FANSI-CONSOLE. We've already been told by distributors that our price is ridiculously low, but we will keep these prices as long as we can. It is also the case that as the program grows in function, the printed user manual will grow in size, and this will require a higher price for the manual. Updated versions of the program and abbreviated user manual, or versions on differently formatted diskettes, may be purchased from Hersey Micro Consulting, Inc. for $10 (MI+4%) per diskette. This requires a previously or simultaneously paid license fee. The price includes the media, so please do not send us any. We do not want our mailperson to be overwhelmed with incoming packages. Of course, you can also get updates from other customers of Hersey Micro Consulting, Inc., for whatever they charge. Diskettes are currently available in 8-inch SSSD, SSDD, and DSDD formats and most 5-inch DSDD formats. We also expect availability in some sub-4-inch formats when such formats become more common. We're sorry, but we cannot directly support formats requiring one-of-a-kind hardware, such as Victor 9000 (Sirius 1), Apple II, or any type of hard sectored diskettes. Orders requiring such one-of-a-kind hardware will require an extra $25 processing charge per order, assuming we can find such hardware to borrow. We provide software update notice service for a $25 one time fee. This requires a previously or simultaneously paid license fee. This puts you on our mailing list of customers who are interested in being directly notified of the availability of newer versions. We will send you a notice giving an overview of new features and bug fixes in new versions on a quarterly basis. Then you can decide whether to obtain a new version, either directly from us or elsewhere. We will also notify you of the availability of other programs from us. (C) Copyright 1984-85 Hersey Micro Consulting 204 (C) Copyright 1984-85 Hersey Micro Consulting 204 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing ______________________________________________________ 11.5 What do we pay if we have more than one computer? Multiple copy licenses may be purchased from Hersey Micro Consulting, Inc. The charge for such a multiple copy license is basically $25 (MI+4%) (United States) per computer console (CRT) owned by the FANSI-CONSOLE _____________ licensing entity on which FANSI-CONSOLE may be used simultaneously (fair estimates accepted). If additional computers are purchased by the licensing entity, the royalty should be recalculated and the increase paid annually. A multiple copy license covers all use by all employees or students, regardless of whether the computers used are owned by the licensing entity. So home use is included, for example. Multiple copy license pricing does not include any printed user manuals. They may be purchased for an additional $25 (MI+4%) each. Quantity discounts are available. (C) Copyright 1984-85 Hersey Micro Consulting 205 (C) Copyright 1984-85 Hersey Micro Consulting 205 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE ____________________________________________________________ 11.6 Can I get a printed complete FANSI-CONSOLE user manual? The printed user manual in "IBM standard" size loose leaf binders with slip covers may be purchased for $50 (MI+4%). The $50 price includes: the printed manual; a usage royalty fee for one computer console (CRT); one distribution diskette with the program and a magnetically copyable version of the abbreviated user manual. This is the "commercial" version of the program. When the order is prepaid, the price also includes ground shipping by UPS within the USA. Other shipping arrangements require a shipping charge. FANSI-CONSOLE _____________ If you received FANSI-CONSOLE from us or from another commercial product vendor, and did not receive a printed user manual, then you FANSI-CONSOLE _____________ may have received our registration coupon with your FANSI-CONSOLE serial number on it. Receiving that coupon means that vendor has FANSI-CONSOLE _____________ paid us to distribute FANSI-CONSOLE with their product, and it means that your usage royalty for one computer console (CRT) has already been paid for you by the vendor. If you did not receive our registration coupon with your serial number on it, or a printed user manual, then the vendor did not pay your usage royalty fee, and you must pay it yourself. The registration coupon is redeemable for a printed user manual at the reduced cost of $25 (MI+4%). An update for the complete user manual costs $25 (MI+4%), assuming you've purchased the commercial version of the program, or have otherwise payed the usage royalty licence fee. We did not include the complete user manual on the distribution diskettes for several reasons: ________ __ _____ ___ ___ __ _ _________ _____ 1. Frankly, it would not fit in a printable form. At least, not the way we want it printed. 2. Using data compression might have made it fit, but would have scared away some potential users, and made printing inconvenient. 3. An abbreviated user manual is quicker and less discouraging to print, or to download from a bulletin board system. 4. We wanted some control over how it got abbreviated, for people desiring only a shorter form. 5. It provides some small encouragement to pay us for our hard work. (C) Copyright 1984-85 Hersey Micro Consulting 206 (C) Copyright 1984-85 Hersey Micro Consulting 206 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing FANSI-CONSOLE __________________________________________________________ 11.7 Can I publish the FANSI-CONSOLE complete user manual? FANSI-CONSOLE _____________ You may want to include FANSI-CONSOLE with your hardware or software product. Companies interested in publishing the complete user manual should contact us. We would prefer to program than to publish! We can provide you with a license to publish the complete user manual with a distribution diskette; or we can provide you with a license to distribute diskettes with a serialized registration coupons redeemable for reduced cost printed user manuals. The license cost includes the usage royalty fee for one computer console (CRT) for each recipient of a published complete user manual, or the serialized registration coupon. Essentially, all we are doing is selling you a particular lot of serial numbers and a clear conscience. However, your customer gets an even bigger bargain on our product. Generally, we would prefer that you use one or the other of the above licenses if you distribute our software with your product. Distributing our software with your product without the license falsely implies to the customer that you've paid us a royalty and therefore that customer has already paid to use our software. FANSI-CONSOLE ________________________________________________ 11.8 Can I buy the FANSI-CONSOLE program source? FANSI-CONSOLE _____________ The source program for FANSI-CONSOLE is available only by ____ non-exclusive license requiring non-disclosure and only for a very large fee. It is definitely not available as shareware or as a reasonably priced end-user product. We do have some stake in keeping the source to ourselves at least until we have made some money from our efforts. (C) Copyright 1984-85 Hersey Micro Consulting 207 (C) Copyright 1984-85 Hersey Micro Consulting 207 FANSI-CONSOLE _____________ FANSI-CONSOLE FANSI-CONSOLE _____________ FANSI-CONSOLE REGISTRATION FORM Person completing form: Date: Company: Address: When did you first receive this product: Release number: Old serial number: What type of computer are you using it on: What types of software do you use that you FANSI-CONSOLE _____________ have found FANSI-CONSOLE speeds up: Other Comments: (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Hersey Micro Consulting, Inc. Invoice # 8401 P.O. Box 8276 Michigan and Federal Ann Arbor, MI USA 48107 EIN 38-2532624 (313) 994-3259 Date: / / Prices effective thru 09/30/85 Name, address, phone: Product Quantity Price Each Item Total FANSI-CONSOLE _____________ FANSI-CONSOLE: complete user manual ___ @ $50.00 = ______ (includes royalty & disk) software usage royalty ___ @ $25.00 = ______ (includes diskette) update disk DSDD ___ @ $10.00 = ______ (requires paid usage royalty) user manual update ___ @ $25.00 = ______ (requires paid usage royalty) update notice service ___ @ $25.00 = ______ (requires paid usage royalty) Subtotal: ______ 4% sales tax (Michigan residents) x0.04= ______ Shipping if not UPS ground to USA ______ Total: ______ Make checks payable to: Hersey Micro Consulting, Inc. MasterCharge and Visa are accepted. Card number: ____________________ Expires: ______ Retain a copy of this invoice for your tax records. (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE FANSI-CONSOLE _____________ FANSI-CONSOLE USAGE AND PROBLEM REPORT QUESTIONNAIRE We at Hersey Micro Consulting greatly appreciate your taking the time to complete this questionnaire. Your suggestions and comments are important to us, as they help us both to evaluate and improve our products. Please feel free to file this report with us more than once. Person completing form: Date: Company: Address: When did you first receive this product: Release number: Serial number: What type of computer and display adapter was it used on: What MS(PC)-DOS version and other resident programs were being used? During the usage period, about how many hours per day did you use this product on average? Do you have any experience with similar products, even on other computers? If so, please describe the products and computers. (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE How long have been using computers? Please give a brief description of your business and how this product was used: Using a scale of 1 to 10 (1=terrible, 5=average, 10=excellent) please indicate your general satisfaction with the following: The product on the whole: The user manual: The setup procedures: The ease of using this product: The practicality or usefulness of this product: The performance of this product: The help given by Hersey Micro Consulting: The following questions may require more lengthy responses. Please use the reverse side of this sheet or additional sheets of paper as necessary. What would you say are the BEST features of this product? What would you say are the WORST features of this product? List any extraneous or useless features of this product that you have noticed. (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE List any enhancements you would like to see added to the existing features of this product. Describe any problems you have encountered in using this product, including examples if possible. (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Index /A option, attributes 31 /B option, blinking scroll 31 /C option, color what you can 32, 83, 118, 145 /D option, double scan characters 32, 119 /F option, font table address 33, 192 /G option, Ctrl-G bell length 33, 130 /H option, horizontal retrace delay 22, 34 /I option, controller initialization parameters 34 /J option, just DOS macros 35 /K option, keyboard language 35, 133 /L option, lock on Scroll-Lock 24, 25, 36, 124, 157 /M option, memory allocated 37, 46 /N option, no color display 37, 83, 126, 145 /O option, one finger typing 38 /P option, page overlap 38, 132, 157, 158 /R option, recall line maximum 39, 46, 156, 159 /S option, screen save timeout 39, 133 /T option, use ANSI X3.64 TTY ROM BIOS 41 /V option, vertical retrace delay 41 /W option, word wide screen write 42 /X option, extensions 43 /Y option, you should be so compatible 44, 116, 144, 174 50 line display 8, 83, 145 abbreviated user manual 14, 15 access methods, screen 47 adapters 29, 31, 34, 37, 40, 41, 42, 43, 126 adapters, compatible 186 Alt-Ctrl-Caps 176 Alt-Ctrl-DownArrow 117, 174 Alt-Ctrl-Esc 177 Alt-Ctrl-Ins 8, 170 Alt-Ctrl-Num-Lock 128, 171 Alt-Ctrl-Scroll-Lock 175 Alt-Ctrl-Tab 177 Alt-Ctrl-UpArrow 117, 174 Alt-Scroll-Lock 124, 157 ANSI - ANSI/VT52 mode 62 ANSI mode 62 ANSI X3.64 4, 41, 127 ANSI X3.64 escape sequences 50, 51, 53, 59 ANSI X3.64 mnemonic table 106 ANSI X3.64 name table 111 ANSI.SYS device driver 2, 4, 18, 26, 28, 51, 52, 58, 110, 122 ANSI40.TXT 52 ANSI80.TXT 52 assembly language, escape sequences 57 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE assignment strings 167 attributes 31, 32, 37, 118, 126 auto repeat keyboard keys 91 auto wrap mode 105 back space 62 background color 96, 118, 126 backward 62, 65, 66 BASIC, escape sequences 54 BBS 206 beginning state 90 BEL - BELl 62 bell 62 bell frequency 130 bell length 33, 130 BIOS 144 BIOS calls 135 BIOS calls, screen 144 BIOS, keyboard 137 BIOS, TTY calls ANSI X3.64 41, 127 blinking 95 blinking, getting rid of the scroll 31 bold 94, 95 breakpoint 8, 170 BS - Back Space 62 BSLASH 59 BUFFERS=20 20 bugs 181 bulletin board system 180, 206 C language, escape sequences 55 caps lock 128 caps lock, true 115 CARET 59 carriage return 65 CBT - Cursor Backward Tabulation 62 CHA - Cursor Horizontal Absolute 63 character delete 68 character erase 72 character insert 84 character names 59 cheating 135 CHT - Horizontal Tabulation 63 CK - Cursor Key mode 63 CNL - Cursor Next Line 64 color 9, 32, 95, 96, 118, 120, 126 color ROM BIOS calls 37, 126 color what you can 32, 118 commercial version 206 compatibility 44, 116, 174 compatible adapters 186 compatible computers 186 compatible programs 183 complete user manual 206 compression 206 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE computer independence 47 computers, compatible 186 CONFIG.SYS 17, 18, 19, 20, 26, 28, 29 console 1 console driver 18 control functions, do 119 control sequence introducer 65 controller initialization 34 conventions 59 CPL - Cursor Preceding Line 64 CPR - Cursor Position Report 64 CR - Carriage Return 65 CSI - Control Sequence Introducer 65 CTC - Cursor Tabulation Control 65 Ctrl-Break 25, 71, 85 Ctrl-C 25, 71, 85 Ctrl-F 24 Ctrl-G 33, 62, 130 Ctrl-H 62 Ctrl-I 79 Ctrl-J 86 Ctrl-K 105 Ctrl-M 65 Ctrl-Num-Lock 24, 25, 36, 124 Ctrl-S 24, 25, 36, 124 Ctrl-[ 74 CTTY 49 CUB - CUrsor Backward 66 CUD - CUrsor Down 66 CUF - CUrsor Forward 66 CUP - CUrsor Position 67 current graphics rendition 32, 92, 93, 118 cursor backward 66 cursor backward tab 62 cursor down 66, 67 cursor forward 66 cursor horizontal absolute 63 cursor horizontal tab 63 cursor key mode 63 cursor left 66 cursor movement 62, 63, 64, 65, 66, 67, 79, 80, 85, 86, 87, 88, 89, 90, 91, 102, 104, 105 cursor next line 64 cursor position 67 cursor position report 64 cursor preceding line 64 cursor right 66 cursor tabulation control 65 cursor up 67 cursor vertical absolute 104 cursor vertical tabulation 67 CUU - CUrsor Up 67 CVT - Cursor Vertical Tabulation 67 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE DA 31 DA - Device Attribute 68 data compression 206 DCH - Delete CHaracter 68 dealers 205 DEC VT100 emulation 5, 128, 171 DEC VT52 emulation 5 DEC-ANM 62 DEC-ARM 91 DEC-AWM 105 DEC-CKM 63 DEC-KPAM - DEC Key Pad Alternate Mode 86 DEC-KPNM - DEC Key Pad Numeric Mode 86 DEC-OM 88 DEC-RM - DEC Reset Mode 68 DEC-SCNM 92 DEC-SM - DEC Set Mode 70 DEJAVU 163 Del 159 delay, horizontal retrace 34 delay, key repeat 131 delay, vertical retrace 41 delete character 68 delete line 71 deleting scroll recall lines 160 device attribute 68 device driver 18, 27 device status report 72 DEVICE= 17, 18 disable keyboard 71, 85 disable manual input 71 disclaimer 203 display control characters 119 display erase 73 display, BIOS calls 144 display, software interrupt 144 distribution 197 distribution diskette 13 DL - Delete Line 71 DLE - Data Link Escape 71 DMI - Disable Manual Input 71 do control functions 119 documentation 14, 15, 206 double scan characters 32, 119 down 64, 66, 67, 85, 86 DownArrow 158 DSR - Device Status Report 72 Dvorak keyboard 13, 165, 177 DVORAK.TXT 13, 52, 177 ECH - Erase CHaracter 72 ED - Erase in Display 73 editing mode, horizontal 78 editing mode, vertical 104 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE EL - Erase in Line 73 EMI - Enable Manual Input 74 emulation, DEC VT100 5, 128, 171 emulation, DEC VT52/Heath H19/Zenith Z100 5 enable keyboard 74, 85 enable manual input 74 End 158 erase character 72 erase display 73 erase line 73 erase screen 73 ESC 59 ESC - ESCape 74 escape 74 escape sequence mnemonic table 106 escape sequence name table 111 escape sequences 4 extensions 43 F1 160 F2 160 F3 160 F4 160 F8 160 FANSI 1 FANSI-1PRT - FANSI 1 PRinT mode 129 FANSI-BELL - FANSI Ctrl-G BELL length 33, 130 FANSI-CAPS - FANSI true CAPS lock mode 115 FANSI-CLICK - FANSI key CLICK frequency 130 FANSI-CMP - FANSI bios CoMPatibility mode 44, 116, 144 FANSI-COLOR - FANSI COLOR what you can mode 32, 83, 118, 145 FANSI-CONTROL - FANSI do CONTROL functions mode 119, 128 FANSI-DBLSCAN - FANSI DouBLe SCAN characters mode 32, 119 FANSI-FILLER - FANSI use FILLER for erase mode 93, 120, 128 FANSI-GRSV - FANSI GRaphics SaVe mode 121, 159 FANSI-HANDICAP - FANSI HANDICAP shift mode 38, 122 FANSI-IBM - FANSI IBM equivalence mode 122 FANSI-JUSTDOS - FANSI JUST DOS macros mode 35, 123 FANSI-KEYDELAY - FANSI KEY repeat DELAY 131, 138 FANSI-KEYRATE - FANSI KEY repeat RATE 131, 138 FANSI-LANGUAGE - FANSI keyboard LANGUAGE 35, 133 FANSI-LOCK - FANSI LOCK on Scroll-Lock mode 36, 124 FANSI-MACRO - FANSI MACROs mode 125, 176 FANSI-NOCOLOR - FANSI NO COLOR display mode 37, 83, 126, 145 FANSI-OVERLAP - FANSI page OVERLAP 38, 132 FANSI-RM 74, 115, 117, 159 FANSI-SAVE - FANSI line SAVE mode 126, 159 FANSI-SCRN - FANSI SCReeN save timeout 39, 133 FANSI-SM 75, 115, 117, 159 FANSI-SOV 77, 130 FANSI-STICKY - FANSI STICKY shift mode 127 FANSI-TTY - FANSI X3.64 TTY bios mode 41, 52, 54, 61, 127, 150 FANSI-UNLOCK - FANSI UNLOCK shift mode 128 FANSI-VT100 - FANSI VT100 equivalence mode 119, 120, 128 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE fast 42, 44, 116 FCONBETA.DEV 17 FCONSOLE.DEV 16, 17, 19, 26, 30 fifty line display 8, 83, 145 file list 13 filler graphics rendition 92, 93, 120, 126 fixed disk 16 flashing, getting rid of the scroll 31 FLAYOUT 164 flicker, getting rid of the scroll 31 font 33 foreground color 95, 118, 126 FORMAT does not work 20 forward 66 free trial period 200 freeware 197 graphics font 33 graphics rendition 32, 92, 93, 118, 126 GRAVE 59 GRCM - Graphics Rendition Combination Mode 78, 94 hard disk 16 hardware requirements 2 hashing 31, 34 Heath H19 emulation 5 HEM - Horizontal Editing Mode 78 highlighting 160, 162 Home 158 home position 89 horizontal and vertical position 80 horizontal editing mode 78 horizontal position absolute 79 horizontal position relative 79 horizontal retrace delay 34 horizontal tab 79 horizontal tabulation set 80 HPA - Horizontal Position Absolute 79 HPR - Horizontal Position Relative 79 HT - Horizontal Tab 79 HTS - Horizontal Tabulation Set 80 HVP - Horizontal and Vertical Position 80 IBM-KKR - IBM Keyboard Key Reassignment 167 IBM-KKR - IBM Keyboard Key Replacement 175 IBM-KKR - Keyboard Key Reassignment 81 IBM-RM - IBM Reset Mode 81, 83 IBM-SM - IBM Set Mode 82, 83 ICH - Insert CHaracter 84 ID - IDentify 84 identify 84 IL - Insert Line 84 incompatible computers 192 incompatible programs 188 IND - INDex 85 index 12, 85, 178 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE initial state 90 initializing crt controller 34 insert character 84 insert line 84 insert mode 85 installing FANSI-CONSOLE, detailed 29 installing FANSI-CONSOLE, simple 13 interlace 119 interlace mode 8, 32, 83, 145 internal parameters 34 interrupt vector, reservation violation 49 interrupt, keyboard 137 interrupt, screen 144 inverse video 95 IRM - Insert-Replacement Mode 85 ISO 6429 4, 51 joke 12, 19, 195 just DOS macro enable 35, 123 KAM - Keyboard Action Mode 85 key pad alternate mode 86 key pad numeric mode 86 key reassignment 81 key repeat delay 131 key repeat rate 9, 131 key values, table 139 keyboad language 133 keyboard action mode 85 keyboard disable 71, 85 keyboard enable 74, 85 keyboard key rearrangement 164 keyboard language 35 keyboard macro enable 125 keyboard macros 81, 167 keyboard replacement strings 167 keyboard, BIOS calls 137 keyboard, software interrupt 137 KKR - IBM Keyboard Key Reassignment 167 KKR - IBM Keyboard Key Replacement 175 KKR - Keyboard Key Reassignment 81 KPAM - Key Pad Alternate Mode 86 KPNM - Key Pad Numeric Mode 86 language, keyboard 35, 133 left 62, 65, 66 LF - Line Feed 86 limitations 181 line delete 71 line erase 73 line feed 86 line feed new line mode 87 line insert 84 literal next character 71 LNM - Line feed New line Mode 87 loadable device driver 27 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE local mode 175 lock, true caps 115 locking scroll 5, 24, 25, 36, 124, 157 macro enable 125 macro enable, just DOS 35, 123 macros 81, 167 manual 14, 15, 206 maximum, recall lines 39 memory limit 37 memory requirements 2, 23, 37, 39, 46 mnemonics, table of ANSI X3.64 escape sequence 106 names, table of ANSI X3.64 escape sequence 111 NEL - NExt Line 87 next line 87 next page 87 normal keyboard 165, 177 NP - Next Page 87 one finger pause 36, 124 one finger typing 38, 122, 127 one print key 129 option 28 options, installation 29 ORIG - ORIGin mode 88 origin mode 88 output redirection 49 overlap 38, 132 P1 60 P2 60 P3 60 P4 60 page overlap 38, 132, 158 parameter 28 parameters 60 parameters, installation 29 parameters, internal 34 PASCAL, escape sequences 56 pause 5, 24, 25, 36, 124, 157 PgDn 158 PgUp 158 Pi 60 positioning unit mode 88 PP - Previous Page 88 prefix 65 previous page 88 primary graphics rendition 92, 93, 118, 126 print key, one 129 print spooler 23 printed user manuals 206 problem, Alt-Ctrl-Ins causing breakpoint in wrong place 170 problem, any kind 178 problem, bad or missing FCONSOLE.DEV 26 problem, bad or missing FCONSOLE.DEVLE.DEV 17 problem, blinking 31 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE problem, can not delete scroll recall lines 160 problem, character is not displayed 71 problem, characters overwritten 44, 116 problem, characters written in wrong place 44, 116 problem, confuses keyboard macro program 173 problem, Ctrl-P key 22 problem, Ctrl-PrtSc key 22 problem, Ctrl-X key 22 problem, delay before prompt 22 problem, different colors after restore 40 problem, does not change colors 22 problem, escape key 22 problem, everything is in black and white 83, 94 problem, file access increases 23 problem, flashing 31 problem, flicker 31 problem, FORMAT does not work 20 problem, hangs AT&T 6300 43 problem, hashing 34 problem, how to check for interactions 179 problem, how to check that FANSI-CONSOLE is cause 179 problem, INS status word is wrong 157 problem, installation 19 problem, keyboard lights do not light on AT&T 6300 43 problem, keys do not all work on properly on Data General One 43 problem, keys do not all work on properly on Tandy 1000 43 problem, keys do not all work properly on MAD-1 43 problem, lack of memory 179 problem, memory usage 18, 192 problem, no more environment space 22 problem, no status line 157 problem, not enough memory 23 problem, not replacing keyboard keys 81 problem, prompt does not set colors with echo off 22 problem, same without FANSI-CONSOLE 179 problem, screen distorted after restore 40 problem, screen save does not work 31, 40 problem, screen save does not work on Zenith 150/160 43 problem, scroll recall does not work 156 problem, scroll-lock key 36, 124 problem, scrolled lines are not saved 159 problem, seems slow 159 problem, slow scroll 31 problem, snow 34 problem, strange shape characters 33 problem, tab stops do not get set right 79 problem, unreadable characters 37, 126 problem, wrong attributes 118 problem, wrong colors 118 problem, wrong colors after program ends 21 program source 207 programming escape sequences 53 PROMPT 21 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Ps 60 PUM - Positioning Unit Mode 88 RAM disk 18, 23 ramdisk 28 rate, key repeat 9, 131 raw mode 79 RC - Restore Cursor 89 RCC - Report Cursor Content 89 RCP - Restore Cursor Position 89 rearrangement of keyboard keys 164 recall buffer 156, 159 recall line maximum 39 recall status line 38, 132, 157 recall viewing screen 157 redirection 49 reentering lines 162 removing FANSI-CONSOLE 26 REP - REPeat 90 repeat character 90 repeat delay, key 131 repeat keyboard keys 91 repeat rate, key 9, 131 replacement mode 85 replacement strings 167 report 64, 68, 72, 89 report cursor content 89 reset modes 68, 74, 81, 91, 115 reset to initial state 90 restore cursor position 89 retrace delay, horizontal 34 retrace delay, vertical 41 return 65 reverse index 90 reverse video 95 RI - Reverse Index 90 right 66 RIS - Reset to Initial State 90 RM 74, 115 RM - Reset Mode 68, 81, 91 ROM BIOS 9, 18, 144 ROM BIOS calls 135 ROM BIOS, keyboard 137 royalty 198 RPT - auto RePeat keys 91 Sav 159 save cursor position 91 saving scroll recall lines 163 SC - Save Cursor 91 SCP - Save Cursor Position 91 screen display mode 31, 33, 34, 40, 41, 44, 81, 82, 83, 94, 116, 118, 126 screen display redirection 49 screen erase 73 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE screen mode 92 screen save timeout 7, 39, 133 screen writing 3 screen writing methods 47 screen, BIOS calls 144 screen, software interrupt 144 SCRN - SCReeN mode 92, 93, 94, 96 scroll down 92 scroll left 98 scroll lock 5, 24, 25, 36, 124, 157 scroll recall 6 scroll recall feature 36, 38, 39, 121, 124, 126, 132, 156, 160, 163 scroll right 101 scroll slow 31 scroll up 103 Scroll-Lock 5, 24, 25, 36, 124, 157 scrolling 71, 84, 85, 86, 87, 88, 90, 92, 98, 101, 102, 103 scrolling region 5, 102 SD - Scroll Down 92 set graphics rendition 93 set modes 70, 75, 82, 99, 115 set option value 77, 130 set scrolling region 102 setting up FANSI-CONSOLE, simple 13 SGR - Set Graphics Rendition 78, 82, 93 shift keys 38, 122, 127, 128 site licenses 205 SL - Scroll Left 98 slow 42, 44, 116 slow scroll 31 SM - Set Mode 70, 82, 99 snapshot 159 snow 31, 34, 42 Snp 159 software interrupt, keyboard 137 software interrupt, screen 144 source program 207 SP 59 speed 42, 44, 116 SPIT.EXE 52 SR - Scroll Right 101 SSR - Set Scrolling Region 102 ST - String Terminator 103 standard keyboard 165, 177 starting state 90 status line 38, 132, 157 status report 72 string terminator 103 SU - Scroll Up 103 switches, installation 29 system disk 17, 20 tab 63, 79, 105 tab stop, clear 65 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE tab stop, set 65 tabulation clear 103 TBC - TaBulation Clear 103 terminal emulation 5 text movement 68, 71, 84, 85, 86, 87, 88, 90, 92, 98, 101, 102, 103, 104 TILDE 59 timeout, screen save 7, 39, 133 trial period 200 TTY, BIOS calls ANSI X3.64 41, 127 typeahead buffer 6, 17, 188 typeahead flushing 6, 24 typeahead limit 6 underlining 95 uninstalling FANSI-CONSOLE 26 unit mode 88 up 64, 67 UpArrow 158 update notice service 204 updated versions 204 user manual 14, 15, 206 using FANSI-CONSOLE, simple 24 VEM - Vertical Editing Mode 104 verify distribution diskette 13 versions 182 vertical editing mode 104 vertical position absolute 104 vertical position relative 104 vertical retrace delay 41 vertical tab 105 vertical tabulation set 105 VPA - Vertical Position Absolute 104 VPR - Vertical Position Relative 104 VT - Vertical Tab 105 VT100 emulation 5, 128, 171 VT52 emulation 5, 62 VT52 mode 62 VTS - Vertical Tabulation Set 105 window 5, 10, 102 word wide screen move 42 WRAP - auto WRAP mode 105 wrapping mode, auto 105 writing 3 writing escape sequences 53 writing methods, screen 47 Z100 emulation 5 (C) Copyright 1984-85 Hersey Micro Consulting (C) Copyright 1984-85 Hersey Micro Consulting 
